Transfers

Confirm a transfer quote

post/v1/transfers/quotes/{confirmationReference}/confirm

Path parameters

confirmationReferencestring required

Opaque confirmation reference returned by quote creation.

Headers

X-API-Keystring

API key

Idempotency-Keystring required

Required UUID preventing duplicate confirmations.

Response

Transfer created from the quoted intent.

transferIdstring required
flowstring required

Customer-facing transfer flow.

statusstring required

Current customer-facing transfer status.

fundingRequiredboolean required

Whether customer funding is required.

fundingDeadlinestring date-time

Customer funding deadline when funding is required.

Example response

{
  "transferId": "tfr_abc123",
  "flow": "FIAT_TO_CRYPTO",
  "status": "PENDING",
  "fundingRequired": true,
  "depositInstructions": {
    "type": "crypto",
    "paymentRail": "ETHEREUM",
    "toAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "amount": {
      "currency": "USD",
      "exponent": 2,
      "value": "12345",
      "displayValue": "123.45"
    },
    "accountId": "acc_abc123"
  },
  "fundingInstructions": {
    "reference": "CDX-7K2A9V",
    "currency": "EUR",
    "amount": "10000",
    "supportedRails": [
      "SEPA"
    ],
    "bank": {
      "name": "Commerzbank AG",
      "address": "Mainzer Landstraße 153, 60327 Frankfurt",
      "country": "DE"
    },
    "accounts": [
      {
        "supportedRails": [
          "SEPA"
        ],
        "accountHolderName": "Acme Onramp Ltd",
        "accountNumber": "12345678",
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "sortCode": "12-34-56",
        "routingNumber": "021000021"
      }
    ],
    "swiftRoutingBanks": [
      {
        "bankName": "Citibank N.A.",
        "bic": "CITIUS33XXX",
        "abaRoutingNumber": "021000089"
      }
    ],
    "expiresAt": "2026-05-26T19:54:00.000Z"
  }
}

Changes

Changed in 1 of the 19 revisions of this API.1