Send transfer responses

​

A participant must accept or reject incoming transfers using this endpoint. This is used by you when you are the IFR to accept or reject incoming transfers.

Body

application/json

Transfer response, as sent by the financial institution confirming or rejecting a transfer

  • document
    Type: object
    required

    Envelops the message content

    Properties: 2

Responses

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/responses
curl https://sandbox-gateway.shinkansen.finance/api/responses \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Shinkansen-JWS-Signature: YOUR_SECRET_TOKEN' \
  --header 'Shinkansen-Api-Key: YOUR_SECRET_TOKEN' \
  --data '{
  "document": {
    "header": {
      "message_id": "1df9acc5-4ec3-4866-b3ee-f6522841dfce",
      "creation_date": "2022-04-08T18:25:45-04:00",
      "sender": "TENPO",
      "receiver": "SHINKANSEN"
    },
    "responses": [
      {
        "transaction_type": "transfer",
        "transaction_id": "326779d2-56c0-4344-9d47-a0d87ba01600",
        "shinkansen_transaction_id": "db93ad2b-a641-418e-bed9-662d93eb97ae",
        "response_id": "ce4a51dd-e008-4623-ad3f-1fb90b4531ce",
        "response_status": "approved",
        "network_metadata": {
          "authorization_code": "123456"
        }
      }
    ]
  }
}'

{
  "shinkansen_message_id": "903feb07-8a90-4e2a-ab4c-cec902903263",
  "responses": [
    {
      "response_id": "c5bae6b3-7c11-4b09-aad8-340ecc1a042c",
      "shinkansen_response_id": "a517a741-e84f-4ac1-8d9d-922162fc703b"
    },
    {
      "response_id": "6f913677-8d84-4dae-a30d-3639608ec3f3",
      "shinkansen_response_id": "4266ca42-b990-4f59-9b08-623660a72ee2"
    }
  ]
}

Message correctly received and accepted to be processed by Shinkansen Gateway and sent to Switch (CCA -> IFO)

Previous
Send transfers
Next
Get a transfer status