Get a transfer status

​

Returns the current state of an outbound transfer and its full reversal history as stored in the Gateway. This endpoint queries gateway state only; it does not send a live consult to the switch network.

Use it when the participant needs to confirm transfer and reversal outcomes (for example after a webhook timeout or during SAF retries). The root-level reversed boolean indicates whether the transfer was effectively reversed; reversals lists every reversal attempt with its own status and CCA response.

Path Parameters

  • UUID v4 identifying the transfer. The gateway resolves it in this order:

    1. Shinkansen internal transaction ID (shinkansen_transaction_id from the transfer ACK).
    2. Participant transaction ID (transaction_id from the original transfer request).

Responses

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/transfers/{shinkansen_id}/status
curl https://sandbox-gateway.shinkansen.finance/api/transfers/123e4567-e89b-12d3-a456-426614174000/status \
  --header 'Shinkansen-Api-Key: YOUR_SECRET_TOKEN'
{
  "transaction_id": "957448bf-2d65-4384-a0cd-2a3fbadedd93",
  "shinkansen_transaction_id": "bddc94cb-506a-4dad-a3e1-be52e3454ec6",
  "status": "ok",
  "response_status": "approved",
  "amount": "70000",
  "currency": "CLP",
  "reference": "Shinkansen Test",
  "tracenumber": 293,
  "switch_timestamp": "2026-06-29T11:58:15",
  "gateway_timestamp": "2026-06-29T15:58:15Z",
  "reversed": true,
  "reversals": [
    {
      "reversal_id": "ffb64ae1-bf39-4a66-8858-552f37176c44",
      "shinkansen_reversal_id": "bacf2eba-7dfa-46e8-b7b1-8966681da8b2",
      "reversal_type": "reversal_conditional",
      "status": "ok",
      "response_status": "approved",
      "tracenumber": 293,
      "received_at": "2026-06-29T15:58:29Z",
      "switch_timestamp": "2026-06-29T11:58:29"
    }
  ]
}