💰🔔Payin Notifications
Una visión general del producto Payin Notifications
Payins Notifications
Una 💰🔔Payin Notification ("notificación de payin") es un mensaje enviado por Shinkansen hacia un participante de la red (cliente de Shinkansen) que notifica una entrada de dinero a una cuenta bancaria.
Un mini-glosario antes de continuar:
- Participant(e): Una fintech/startup que está conectada a la red Shinkansen y desea recibir notificaciones sobre las entradas de dinero en su cuenta.
- Debtor: En el contexto de Payins, es el originador del movimiento, es decir, quien envió el dinero.
- Creditor: En el contexto de Payins, es el destinatario del movimiento, es decir, el Participante.
- Creditor FI (financial institution): entidad financiera donde el Participante tiene una cuenta corriente y de la cual Shinkansen recibe o extrae la información.
Desde el punto de vista de quien recibe una 💰🔔Payin Notification es básicamente un webhook:
sequenceDiagram
autonumber
Shinkansen--)Participante: POST(PayinNotification) via Participant webhook: `/notifications`
Contenido de las 💰🔔Payin Notifications
Si bien el contenido de la notificación puede variar (muy ligeramente) entre países, el objetivo de Shinkansen siempre será entregarte toda la información útil relacionada a la transacción, por lo cual privilegiamos integraciones directas con el la institución financiera donde se recibe el dinero (Creditor FI).
Los datos más relevantes de nuestra notificación son:
- Monto de la transacción
- Número de cuenta del Participante/Creditor
- Institución financiera del Participante
- ID del Participante
- ID único de la transacción
- Moneda
- Nombre del Debtor
- 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, que puede variar por país u institución.
API Reference
En https://docs.shinkansen.tech/reference/post-notifications-webook puedes encontrar la referencia universal de notificaciones. Los tipos de notificaciones relacionados con payins son:
-
notification_type = "payin"
: Notificación de entrada de dinero. -
notification_type = "payin_reversal"
: Notificación de reversa de entrada de dinero.
Updated 10 months ago