Settlement instructions
A settlement instruction is a destination you save once and reuse: a bank account or a crypto wallet that funds settle to. You reference it by ID instead of re-entering the bank or wallet details each time.
Settlement instructions are the saved destinations for OTC orders. When you place an order with destination_type set to ssi, the destination_id is the settlement instruction the proceeds settle to.
Settlement instruction vs external accountA settlement instruction is where you receive settled funds (for example, the bank account that receives the proceeds of an FX order). An external account is a payee you send funds to. They're separate.
Instruction types
| Type | Use it for | Key fields |
|---|---|---|
bank_account | settling to a bank account | account_number, bank_name, plus routing_number, swift_code, or iban depending on the corridor |
crypto_wallet | settling to a crypto wallet | wallet_address, network, and memo where the network needs one |
Each instruction has a currency and a status of active or inactive. You can mark one instruction as the default per currency with is_default.
Next step
See Manage settlement instructions to create, list, update, and delete them.
Updated 3 months ago
