Find your Flow

📘 Six guides, thirteen flows

Every order you create resolves to one of thirteen flows. The question that decides which one is simple: where do the funds sit before and after the order?

Where the money is	Flows	Guide
Outside TransFi → outside TransFi — value passes straight through, never touching your balance	Fiat → Crypto Crypto → Fiat Fiat → Fiat Crypto → Crypto	Instant Flows
Outside → into your balance — from a named payer	Crypto Payin Fiat Payin Fiat Payin with Wallet	Collections
Outside → into your balance — from you	Fiat Prefund Crypto Prefund	Add Funds
Your balance → outside	Fiat Payout Fiat QR Payout Crypto Payout	Payouts
Within your balance	Balance Transfer (Swap)	Swaps

Two pages support every flow above:

Page	What it covers
Settlements	How value collected through Flows 7–9 reaches your bank account or wallet — in batches
Who's on Each Side	The three party configurations every flow can take: paying you, paying from you, or one party paying themselves. This is where payments on behalf of your customers (PoBo / CoBo) are explained

Instant, or via your balance?

	Instant Flows (1–4)	Via your balance (5–13)
Does value sit in your TransFi balance?	No — passes through	Yes — enters, leaves, or moves within it
Do you need to top up first?	No	For payouts and swaps, yes
How do you receive collected value?	Directly, to the external account on the order	In batches, via Settlements
Typical users	Trade collections paid straight to a wallet, pass-through payouts, users buying or selling crypto for themselves	Platforms holding a balance, payroll, treasury, anyone paying out at volume

The one endpoint behind all of them

`orderType`	Resolves to	Guide
`payin` — fiat in, external destination	Flow 1 or 3 · Instant collection	Instant Flows
`payin` — fiat in, to your balance	Flow 8 · Fiat Payin	Collections
`payin` — crypto in, to your balance	Flow 7 · Crypto Payin	Collections
`gaming`	Flow 9 · Fiat Payin with Wallet	Collections
`payout` — from your balance	Flow 10 or 12	Payouts
`payout` — `paymentType: "qr"`	Flow 11 · Fiat QR Payout	Payouts
`payout` — pass-through, no balance	Flow 2, 3 or 4 · Instant payout	Instant Flows
`onramp` · `offramp`	Flow 1 or 2, same party	Instant Flows
`swap` — inside your balance	Flow 13 · Balance Transfer	Swaps
`fiat_prefund` · `crypto_prefund`	Flow 5 or 6	Add Funds

→ Create Order · Get Order by ID · List Orders

Rules that apply to every flow

purposeCode is required on every order. It states why money is moving. See Purpose Codes.
partnerId is your idempotency key. One per order, stored before the call. Retry with the same value if a request times out; never reuse it across different orders.
The amount goes in source or destination, never both. In source to spend an exact amount; in destination for the receiver to get an exact amount.
The mid header is required on every call.
Never retry a failed order. Create a new one with a new partnerId.
Act on terminal statuses only. See Orders & Statuses.

Updated about 5 hours ago

Did this page help you?