Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-07-2642128296.2 KB
Transactions & Responses

Sends a payout message

Sends a new payout message, which — if successful — will move funds from the account of one participant of the network to some account on an external network (e.g: traditional bank accounts)

post/messages/payouts

Request body

Example request

{
  "document": {
    "header": {
      "message_id": "014a74cb-597c-46a1-8217-63e58a336b0d",
      "creation_date": "2022-04-08T18:25:43-04:00",
      "sender": {
        "fin_id_schema": "SHINKANSEN",
        "fin_id": "BUK"
      },
      "receiver": {
        "fin_id_schema": "SHINKANSEN",
        "fin_id": "SHINKANSEN"
      }
    },
    "transactions": [
      {
        "transaction_type": "payout",
        "transaction_id": "8af773eb-761d-44a5-86a9-1435189d215c",
        "currency": "CLP",
        "amount": "30000",
        "execution_date": "2022-04-11T10:30:00-03:00",
        "description": "Salary payment",
        "reference_number": "1234567",
        "tracking_key": "AAA1234567",
        "debtor": {
          "name": "Buk SpA",
          "identification": {
            "id_schema": "CLID",
            "id": "12383287-6"
          },
          "financial_institution": {
            "fin_id_schema": "SHINKANSEN",
            "fin_id": "BANCO_BICE_CL"
          },
          "account": "123451",
          "account_type": "current_account",
          "email": "payments@buk.com"
        },
        "creditor": {
          "name": "Romulo Gallegos",
          "identification": {
            "id_schema": "CLID",
            "id": "12383287-6"
          },
          "financial_institution": {
            "fin_id_schema": "SHINKANSEN",
            "fin_id": "SCOTIABANK_CL"
          },
          "account": "1513523451",
          "account_type": "current_account",
          "email": "romulo.gallegos@shinkasen.finance"
        }
      }
    ]
  }
}

Response

Message correctly received. Does NOT mean the transaction was succesful. Transaction result is communicated back on another message.

Example response

{
  "transactions": [
    {
      "transaction_id": "c5bae6b3-7c11-4b09-aad8-340ecc1a042c",
      "shinkansen_transaction_id": "a517a741-e84f-4ac1-8d9d-922162fc703b"
    },
    {
      "transaction_id": "6f913677-8d84-4dae-a30d-3639608ec3f3",
      "shinkansen_transaction_id": "4266ca42-b990-4f59-9b08-623660a72ee2"
    }
  ]
}