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)
