Agent Management12

Agent Operations13

API Tokens4

Available UMA Providers1

Cards5

Contact Verification4

Cross-Currency Transfers6

Customers8

Discoveries1

Documents5

Embedded Wallet Auth12

Exchange Rates1

External Accounts12

Internal Accounts4

Invitations4

KYC/KYB Verifications8

Platform Configuration2

Same-Currency Transfers2

Sandbox14

Stablecoins10

Strong Customer Authentication16

Transactions6

Webhooks

Webhooks14

External Accounts

Verify ownership with a wallet signature

Complete a WALLET_SIGNATURE challenge by submitting the signature the wallet produced for the challenge's messageToSign. The message must be signed exactly as returned, and the signature must be submitted before the challenge's expiresAt — after expiry, start a new challenge.

On success the account moves to ACTIVE; on an invalid signature it moves to UNVERIFIED (start a new challenge to retry). LIVENESS challenges complete asynchronously and never use this endpoint — their outcome is delivered via EXTERNAL_ACCOUNT.STATUS_UPDATED webhooks or by polling the account.

post/platform/external-accounts/{externalAccountId}/verify

Path parameters

externalAccountIdstring required

External account ID

Request body

signaturestring required

The signature produced over the exact messageToSign — EIP-191 hex for EVM chains, base64 for Bitcoin, base58-encoded Ed25519 for Solana.

signatureScheme'bip137' | 'electrum'

Bitcoin message-signing format. Defaults to bip137; use electrum for Electrum/Sparrow wallets. Ignored for non-Bitcoin chains.

Example request

{
  "signature": "0x52d75f01c9e7b8b2ce2fbcbd21bfeeee7bcd1a2f01ce6b8ad9a67a45e83a8f5d1c"
}

Response

Signature valid; the updated external account is returned with status: ACTIVE.

idstring required

The system generated identifier of this account

customerIdstring

The customer this account is tied to, or null if the account is on behalf of the platform.

Status of an external account.

PENDING_OWNERSHIP_VERIFICATION: the wallet's ownership must be verified (e.g. under the EU Travel Rule) before unrestricted use; transfers below regulatory thresholds are still allowed. UNVERIFIED: the most recent verification attempt failed; start a new challenge to retry. Successful verification moves the account to ACTIVE.

platformAccountIdstring

Optional platform-specific identifier for this account

ownershipType'FIRST_PARTY' | 'THIRD_PARTY'

Whether the external account belongs to the customer themselves (FIRST_PARTY) or to someone else (THIRD_PARTY). Required when creating self-custody crypto wallet external accounts on platforms subject to counterparty requirements — for example, under the EU Travel Rule or similar requirements in other regions; recommended for all other accounts, where providing it can unlock additional capabilities and smoother compliance handling.

currencystring required

The ISO 4217 currency code

defaultUmaDepositAccountboolean

Whether this account is the default UMA deposit account for the customer. If true, incoming UMA payments to this customer's UMA address will be automatically deposited into this account instead of the primary internal account. False if not provided. Note that at most, one external account can be set as the default UMA deposit account for a customer. If there is no default UMA deposit account, incoming UMA payments will be deposited into the primary internal account for the customer.

The result of verifying the beneficiary name against the account holder name.

Status	Description
MATCHED	The beneficiary name is an exact match
PARTIAL_MATCH	The beneficiary name is a fuzzy match
NOT_MATCHED	The beneficiary name does not match
UNSUPPORTED	The payment rail does not support name verification
CHECKED_BY_RECEIVING_FI	Verification is deferred to the receiving financial institution (e.g. ACH)
PENDING	Verification is still in progress

Example response

{
  "id": "ExternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965",
  "customerId": "Customer:da459a29-1fb7-41ce-a4cb-eb3a3c9fd7a7",
  "platformAccountId": "acc_123456789",
  "ownershipType": "FIRST_PARTY",
  "currency": "USD",
  "beneficiaryVerifiedData": {
    "fullName": "John Doe"
  },
  "accountInfo": {
    "accountType": "AED_ACCOUNT",
    "iban": "AE070331234567890123456",
    "swiftCode": "EBILAEAD"
  }
}

Changes

Changed in 3 of the 24 revisions of this API.15

Aug 20, 20264f1f6b937f937See the full diff
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #38: Base Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #39: Ethereum L1 Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #41: Polygon Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #42: Plasma Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #43: Solana Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #44: Spark Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletCustodyFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #45: Tron Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
Aug 15, 202627ff0fdca01c7See the full diff
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #38: Base Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #39: Ethereum L1 Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #41: Polygon Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #42: Plasma Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #43: Solana Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #44: Spark Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added WalletBeneficiaryFields to the allOf[subschema #1]/accountInfo/oneOf[subschema #45: Tron Wallet]/ response property allOf list for the response status 200
  response-property-all-of-added
Aug 14, 2026aaa1fb8782c81See 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

Full history