Skip to main content
A transfer moves money between two of your own accounts: GBP to NGN to fund a local payroll account, or from “Operations” to “Payroll” in the same currency. To pay someone else, send a payment instead. Scopes: transfers:write to quote and transfer, transfers:read to check. transfers:write moves money.

Same currency

Different currencies

1

Quote

Give exactly one amount: what leaves (amountFromMinorUnits) or what arrives (amountToMinorUnits).
The quote’s amountFromMinorUnits and amountToMinorUnits are what will move. rateMicro is the rate × 1,000,000, for display. The quote expires at expiresAt.
2

Transfer with the quote

The quoted amounts are used, so there’s no minorUnits. An expired or used quote is 409 QUOTE_UNUSABLE: get a new one.

Outcome

A 200 instead of 201 means your idempotency key already named a transfer, which is returned unchanged. Keep idempotency keys for transfers to 100 characters or fewer.

What can’t move

Some pairs of accounts can’t transfer to each other, for example when the two accounts are held at different banking partners. That’s 422 UNSUPPORTED. Not enough available balance is 402 INSUFFICIENT_FUNDS.