💸🤝 Payout Transactions
Automatizar pagos salientes, dispersar pagos.
Payouts: Flujo
Un Payout o 💸🤝 Payout Transaction en Shinkansen es un movimiento de fondos desde un participante de Shinkansen hacia un titular final fuera de la red Shinkansen (por ejemplo Cuenta bancaria). Es decir, se trata de una transferencia electronica a una persona (natural o jurídica).
Un mini-glosario antes de continuar:
- Participant(e): Una fintech/startup que está conectada a la red Shinkansen.
- Debtor: En el contexto de Payout, el originador del movimiento, que es un Participante.
- Creditor: En el contexto de Payout, el destinatario del movimiento.
- PO: Operador de Pagos, partner de Shinkansen, que ejecuta la dispersión de fondos (ej: un banco)
Desde el punto de vista de quien envía un Payout, los mensajes intercambiados con Shinkansen lucen así:
sequenceDiagram
autonumber
Participante-)Shinkansen: POST(PayoutMessage) via Shinkansen endpoint: /messages/payouts
Shinkansen--)Participante: POST(ForwardedPayoutResponseMessage) via Participant webhook: .../responses
Shinkansen es una red de intercambio de mensajes
Para ser eficientes, los mensajes son asíncronos. Eso significa que las respuestas (de éxito o fracaso) son recibidas por los Participantes a través de webhooks.
Desde el punto de vista de quien procesa un message Payout, el intercambio con Shinkansen luce así:
sequenceDiagram
autonumber
Shinkansen-)PO: POST(ForwardedPayoutMessage) via PO webhook: .../transactions
PO--)Shinkansen: POST(PayoutResponseMessage) via Shinkansen endpoint /messages/responses
El rol de Shinkansen es rutear y validar mensajes. Si juntamos todo, tenemos:
sequenceDiagram
autonumber
Participante-)Shinkansen: PayoutMessage via Shinkansen endpoint: /messages/payouts
Shinkansen-)PO: ForwardedPayoutMessage via PO webhook: .../transactions
PO--)Shinkansen: PayoutResponseMessage via Shinkansen endpoint /messages/responses
Shinkansen--)Participante: ForwardedPayoutResponseMessage via Participant webhook: .../responses
Asumiendo el caso feliz, a través de este intercambio de mensajes se han transferido fondos desde el Participante hacia una persona natural o jurídica fuera de la red Shinkansen.
Updated 10 months ago