v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB
Trusted Beneficiary

Initiate marking a USDC address as Trusted Beneficiary

Only USDC, USDC_POLYGON, and USDC_SOL addresses are eligible; other currencies are rejected with 30075 (CURRENCY_NOT_TRUSTABLE).

post/wallets/beneficiary/address/trust

Request body

userIdstring required
whitelistedAddressIdstring required
verificationMethod'sms' | 'totp' | 'passkey'

Defaults to sms when omitted.

Response

Challenge issued. Factor-specific fields populated based on verificationMethod (challengeId+dateExpires for sms, options+allowedOrigins+relyingPartyId for passkey, ok for totp).

verificationMethod'sms' | 'totp' | 'passkey' required
okboolean
challengeIdstring
dateExpiresstring
allowedOriginsstring[]
relyingPartyIdstring