Payin Notifications
Una 💰🔔Payin Notification ("notificación de payin") es un mensaje enviado por Shinkansen para notificar la entrada de dinero a una cuenta.
Desde el punto de vista de quien recibe una 💰🔔Payin Notification es básicamente un webhook:
Contenido de las 💰🔔Payin Notifications
Los datos más relevantes de estas notificaciones son:
- Monto de la transacción
- Moneda
- Número de cuenta del Creditor donde se recibe el dinero (es decir, la empresa que recibe esta notificación)
- Institución financiera del Creditor
- ID del Creditor
- ID único de la notificación
- Nombre del Debtor (contraparte que generó la transferencia o envió la transacción)
- ID del Debtor
- Institución Financiera del Debtor
- Hora de recepción de la transacción
- Hora de envío del mensaje por parte de Shinkansen
- Glosa o Leyenda
- Otra metadata de la transacción.
Ojo con la idempotencia y la validación de firma en las notificaciones
En las notificaciones, tú eres el servidor (mediante tu webhook) y nosotros el cliente que nos conectamos a ese endpoint.
Por ende es crítico que verifiques siempre la firma de Shinkansen en cada mensaje que llegue a tu webhook. Y también es igual de importante que manejes la idempotencia desde el lado servidor, verificando los ids de mensaje para evitar duplicados y respondiéndonos un 409 cuando te hayamos enviado un duplicado
En Shinkansen siempre preferiremos enviar de nuevo un mensaje en caso que no estemos 100% seguros de recibir tu confirmación, y esto puede pasar por razones ajenas al funcionamiento de tu webhook (por ejemplo si hubiera un problema de red que impide que recibamos tu respuesta aunque tú la envíes correctamente)