Transfers

Bridge's /transfers resource. Onramps, offramps, and wallet-to-wallet transfers.

Endpoints

• POST /transfers: create a transfer. Returns funding instructions.
• GET /transfers: list transfers with filter + pagination.
• GET /transfers/{id}: fetch a single transfer.
• PUT /transfers/{id}: partial update, valid only while awaiting_funds.
• DELETE /transfers/{id}: cancel. Valid only in awaiting_funds.

Shared reference

Currencies

Supported

• Fiat: brl, cop, eur, gbp, mxn, usd.
• Stablecoin: usdc.

Not supported: dai, eurc, pyusd, usdb, usdt. Bridge lists these. They cannot be settled. Transfers referencing an unsupported currency return 422 unsupported_currency.

Payment rails

Fiat: ach, ach_push, ach_same_day, wire, swift, sepa, faster_payments, pix, spei, bre_b, co_bank_transfer.

Crypto (supported): base, ethereum, arbitrum, optimism, polygon, solana, avalanche_c_chain, celo, stellar, tron, tempo.

For the countries and rails the platform covers, see Local rails.

Crypto (not supported): bridge_wallet: not implemented. Transfers referencing bridge_wallet return 422 unsupported_rail. See Bridge Wallets in Not implemented.

States

awaiting_funds → funds_received → payment_submitted → payment_processed
                      ↘ in_review ↗
                                    ↘ undeliverable | returned → refund_in_flight → refunded
                                                                                   ↘ refund_failed
awaiting_funds → canceled