destination_ id. The settlement profile is the one destination currently chosen, and every payment and deposit snapshots it at the moment that object is created.
List the account’s destinations
limit from 1 to 100, and filters on type and status. resource is a privacy-safe projection of the linked wallet or bank account.
Only crypto wallets can receive settlement today
The list describes everything the account holds, not a menu of what is selectable.
Every kind is normalised behind one
settlementDestinationId, so a payment body never carries a wallet address, an account number or a currency. Every supported settlement chain can hold a crypto destination; see Supported regions and currencies.
A bank or rail destination returns settlementSupported: false with an unavailableReason. Selecting one is refused with payment_method_not_supported.
Offer a destination only when settlementSupported is true
Set the settlement profile
assetSymbol is optional and accepts USDC, USDT, THBT, JPYC or USDG: THBT is Movement-only, JPYC is Polygon-only and USDG is Robinhood Chain-only (4663). A native asset is never a destination.
The response is the versioned profile:
- Read
status; don’t assume it. Only anactiveprofile receives value. - A recipient needs an active profile. A receive payment naming an account whose profile is not active is refused with
settlement_profile_required(422); a send to such an account is refused with409 conflict. - Repeats are safe. Repeating the same selection returns the existing profile rather than writing a new one.
- Changes apply forward only. Payments already created and deposits already detected keep the destination captured at that moment.
- No profile reads as
null.GET /v2/accounts/{accountId}/settlement-profilereturns{ "settlementProfile": null }when nothing is selected. Design your settings screen around that state.
Override the destination for one payment
A receive payment can name a different eligible destination without touching the profile:An account without a destination cannot receive value
Errors
account.updated fires when a destination is linked, changed or disabled. Treat it as a prompt to read the account.
Next: Webhooks
The event catalog, signature verification and delivery rules.