Skip to main content
Every integration is a combination of six capabilities. Each is expressed through the same two resources, Account and Payment, so learning one makes the next cheaper. A capability is available to you only when GET /v2/partners/config says so. It must be in your agreement, allowed for the calling key, and switched on for your app. Crypto capabilities need no verification. Fiat ones add compliance on top: your organization completes KYB once, then each account that uses a fiat product is verified in its own right. The config response reports both under compliance.

Collect

Receive funds into an account. Collected funds are held in a per-payment escrow and credited only when the expected receipt is verified.

Hold

An account does not hold a spendable balance. GET /v2/accounts/{accountId}/balances returns a reporting projection with custodyScope: "not_a_custody_balance". It is a reconciliation and statement feed. It can be negative, and it does not decrease when value settles out to a customer’s own wallet. Value rests in the customer’s own wallet, their Vault, or their bank account. If your product needs a spendable balance, that ledger is yours to keep.

Convert

Conversion is not a standalone resource. There is no Conversion object and no convert endpoint. Where a payer pays in one chain or asset and the recipient is owed another, the conversion is selected as part of the payment option during routing, and it settles inside the same Payment. The payer sees what they pay; the recipient receives the exact amount they asked for. Use POST /v2/payments/preview to resolve amounts and funding options before creating a send payment. Preview is send-only; a receive payment returns its options once created.

Pay

Send funds out of an account. Every send is a Payment with intent: send. The destination type decides where it lands.

Settle

Settlement is where collected value lands. It is a property of the receiving account, not a decision made per payment. SettlementProfile names the destination; SettlementDestination is the typed target. Settlement runs in stablecoin, to a connected wallet or a Vault. A bank account cannot receive settlement. A payer chooses how to pay. Your backend chooses where the recipient settles. Checkout cannot change it.

Reconcile

Reconciliation is not an endpoint you call. It is the guarantee the rest of the API is built to give you.
  • Every movement is recorded as a Transaction against an account.
  • Webhook events fire when state changes, signed, and are a prompt to read the resource rather than a statement of truth.
  • Crediting happens on verified receipt, so what is recorded matches what arrived.
  • Idempotency keys make retries safe, so a duplicate request cannot become a duplicate movement.

Next

Supported regions and currencies

Where each capability is available.

Objects

Every object, its ID prefix and the rule to know.