Notificaciones de Metadata. Información relacionada a los pagos.

Last updated: June 2, 2025

¿Qué son las notificaciones de metadata?

Las notificaciones de metadata son mensajes que Shinkansen envía a los clientes para comunicar información adicional relacionada con las transacciones de pago, como URLs de comprobantes o información de entrega.

BBVA

  • Recibos de pago: Para pagos a través hacia otra cuenta BBVA, se envía la URL del comprobante una vez que está disponible.

BCI

  • Información de rastreo: Datos adicionales que ayudan a dar seguimiento al estado del pago como el numero de folio y el nombre de la nómina.

STP

  • Recibos de pago (CEP): Para pagos en México a través de STP, se envía la URL del comprobante CEP una vez que está disponible.

  • Información de rastreo: Datos adicionales que ayudan a dar seguimiento al estado del pago como el numero de referencia o la clave de rastreo.

Características importantes

  • Las notificaciones pueden ocurrir varias veces durante el ciclo de vida de una transacción

  • Cada notificación incluye toda la metadata disponible hasta ese momento

Configuración

Para recibir notificaciones de metadata, es necesario:

  1. Tener asignado un producto que soporte notificaciones de metadata como son los payouts.

  2. Configurar el webhook "Notification metadata endpoint" en el dashboard de Shinkansen en la sección de Configuración/Webhooks.

Estructura de la notificación

Pueden encontrar las especificaciones de la api en la documentación de Shinkansen.

Mejores prácticas

  • Validar la firma JWS de las notificaciones para garantizar su autenticidad

  • Considerar que una transacción puede recibir múltiples notificaciones de metadata.

  • Almacenar la metadata más reciente para cada transacción.