Set an account's settlement preference
Choose which active destination a UPA’s incoming money settles to.
settlementDestinationId returned by List an account’s settlement destinations, and optionally an assetSymbol. The destination must be active: crypto destinations resolve to their linked wallet, and unverified bank and rail destinations fail closed.
Repeating the same preference returns the existing profile. Deposits and Payments that already exist keep their immutable settlement snapshot.
See Settlement destinations.Authorizations
HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.
Headers
Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.
2026-09-09 Path Parameters
Canonical account id returned by the Accounts API.
"acct_123"
Body
Select an active typed settlement destination returned by the settlement-destinations endpoint. Native assets cannot be selected for token settlement. THBT is Movement-only. JPYC is Polygon-only. USDG is Robinhood Chain-only (4663).
Response
Settlement profile
"settle_123"
"acct_123"
x >= 12
"wallet_123"
"destination_123"
draft, active, inactive, failed smart_wallet, connected_wallet, external_wallet Supported settlement chain IDs: Arbitrum=42161, Ethereum=1, Base=8453, Polygon=137, BNB Smart Chain=56, Avalanche=43114, Robinhood Chain=4663, Tempo=4217, Solana=10103, Movement=10002. Settlement currently supports EVM, Solana, and Movement token destinations. Movement also supports THBT, while Polygon supports direct same-chain JPYC settlement. Tron is deposit-only for settlement-fee escrow.
42161, 1, 8453, 137, 56, 43114, 4663, 4217, 10103, 10002 "11111111111111111111111111111111"
USDC, USDT, THBT, JPYC, USDG "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"