v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB

Business Trusted Beneficiary

Mark a USDC address as Trusted Beneficiary (business)

Single-call TOTP-confirmed trust for a business USDC address. Only USDC, USDC_POLYGON, and USDC_SOL addresses are eligible; other currencies are rejected with 30075 (CURRENCY_NOT_TRUSTABLE). The address must already be whitelisted and activated, otherwise the request is rejected with 30073. The supplied totpCode is verified in the same request.

post/business/beneficiary/address/trust

Request body

businessIdstring uuid required

whitelistedAddressIdstring uuid required

totpCodestring required

6–8 character TOTP or recovery code, verified at the time of the request.

Example request

{
  "businessId": "8b1d5f2a-3c4e-4a6b-9f0d-7e2c1a4b5d6e",
  "whitelistedAddressId": "4c8e1b3d-7a2f-4d9c-8b6e-1f0a2b3c4d5e"
}

Response

Trust applied.

okboolean required