💸🤝 Payout Transactions

Automatizar pagos salientes, dispersar pagos.

Suggest Edits

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

editar

Flujo de Payout desde el punto de vista de quien lo envía

ℹ️

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

editar

Flujo de Payout desde el punto de vista de quien lo procesa

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

editar

Flujo completo de un mensaje de Payout

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 5 months ago