Sign in

v1

latestOpenAPI 3.1.02026-07-262343124.1 KB
Crypto Settlement

Update a crypto settlement destination

Change the destination wallet for an existing crypto settlement. The new destination must be a CAIP-10 account on the same chain as the settlement's asset.

put/v1/merchants/{merchantId}/settlements/crypto/{id}

Path parameters

idstring required
Example:crypto_Xk7nWp8XmQj2YrTv6

Crypto settlement ID

merchantIdstring required

Request body

destinationstring required

CAIP-10 account identifier for the wallet that should receive the settled funds. Format: <namespace>:<chain_reference>:<address>. The chain (<namespace>:<chain_reference>) must match the chain of the corresponding asset.

Example request

{
  "destination": "eip155:8453:0x1234567890abcdef1234567890abcdef12345678"
}

Response

Settlement updated

idstring required

Crypto settlement ID

assetstring required

CAIP-19 asset identifier for the token to settle in. Format: <namespace>:<chain_reference>/<asset_namespace>:<asset_reference>. For example, USDC on Base is eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.

destinationstring required

CAIP-10 account identifier for the wallet that should receive the settled funds. Format: <namespace>:<chain_reference>:<address>. The chain (<namespace>:<chain_reference>) must match the chain of the corresponding asset.

Example response

{
  "id": "crypto_Xk7nWp8XmQj2YrTv6",
  "asset": "eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "destination": "eip155:8453:0x1234567890abcdef1234567890abcdef12345678"
}