Sign in
Strong Customer Authentication

Confirm trusting a beneficiary

Finalize trusting a beneficiary (identified by the externalAccountId in the path) by submitting the SCA proof (code for SMS_OTP / TOTP, or passkeyAssertion + origin for PASSKEY), echoing the challengeId when one was issued. Returns trusted: true.

This endpoint is only meaningful for customers in a region where SCA is required (e.g. EU). For customers outside SCA-regulated regions, this returns 409.

In sandbox, the SMS/TOTP code is always 123456.

post/customers/external-accounts/{externalAccountId}/trust/confirm

Request body

OR

Example request

{
  "code": "123456",
  "origin": "https://app.example.com"
}

Response

Beneficiary trusted.

trustedboolean required

Whether the beneficiary is now trusted. true after a successful trust, false after a successful untrust.

Changes

Changed in 8 of the 27 revisions of this API.112

  • f560bb38e8d11See the full diff
    • ●

      added the new STABLECOIN_GRID_ENABLEMENT_NOT_REQUESTABLE enum value to the response property for the response status

      response-property-enum-value-added

  • aaa1fb8782c81See the full diff
    • ●

      added the new EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • df12ec487f0e1See the full diff
    • ●

      added the new TRANSACTION_SIZE_LIMIT_EXCEEDED enum value to the response property for the response status

      response-property-enum-value-added

  • b06902b6595a4See the full diff
    • ●

      added the new CARDHOLDER_KYC_NOT_APPROVED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new CARD_ALREADY_CLOSED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new CARD_NOT_MUTABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new INVALID_STATE_TRANSITION enum value to the response property for the response status

      response-property-enum-value-added

  • 526036c126091See the full diff
    • ●

      added the new END_USER_TERMS_VERSION_NOT_FOUND enum value to the response property for the response status

      response-property-enum-value-added

  • b21ed434ee6e21See the full diff
    • ●

      added the new BENEFICIARY_TRUSTED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new SCA_SESSION_REQUIRED enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • 094458a989d21See the full diff
    • ●

      added the new TRANSACTION_NOT_CANCELLABLE enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 483d0a08414b1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog