Sending international wires

For a foreign-currency wire, create an FX quote and use its fxQuoteId before expiresAt. For a USD international wire, omit fxQuoteId and create the wire directly.

For a foreign-currency wire:

Create an FX quote for the exact beneficiary amount and currency.
Before expiresAt, create the international wire with that quote id.
Keep the returned Transfer id and follow its lifecycle.

Creating an international wire requires a user API key with wire access, used from an allowlisted IP. Amounts use the currency’s minor unit, so 10000 GBP means GBP 100.00.

{
  "amount": { "amount": 10000, "currency": "GBP" },
  "fromAccount": "subaccount_operations123",
  "destinationId": "le_contact_destination_intl123",
  "description": "International invoice 1042",
  "internationalWire": {
    "fxQuoteId": "fx_rate_quote_123",
    "purposeCode": "GDDS",
    "remittanceInfo": "Invoice 1042",
    "intermediaryBankBic": "BARCGB22"
  }
}

amount is what the beneficiary receives. A non-USD amount requires a quote for the exact amount and currency. A USD international wire must omit fxQuoteId. The response has type: "international_wire" and can be retrieved from GET /v2/transfers/international-wire/{transferId}. International wires cannot be canceled through the API.

Get started

Concepts

Money movement

Webhooks

Reference

Sending international wires