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}

Update a crypto settlement destination

cURL

curl --request PUT \
  --url https://api.pay.walletconnect.com/v1/merchants/{merchantId}/settlements/crypto/{id} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "<string>"
}
'

200

Example

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

Authorizations

API KeyApiKeyAppId

Api-Key · string · header · required

Path Parameters

id · string · required

Crypto settlement ID

Required string length: 1 - 256

Example:

"crypto_Xk7nWp8XmQj2YrTv6"

merchantId · string · required

Body

application/json

destination · string · 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.

Required string length: 1 - 256

Pattern: ^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}:[-a-zA-Z0-9]{1,128}$

Example:

"eip155:8453:0x1234567890abcdef1234567890abcdef12345678"

Response

200

application/json

Settlement updated

id · string · required

Crypto settlement ID

Example:

"crypto_Xk7nWp8XmQj2YrTv6"

asset · string · 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.

Required string length: 1 - 256

Pattern: ^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}\/[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,128}$

Example:

"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

destination · string · 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.

Required string length: 1 - 256

Pattern: ^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}:[-a-zA-Z0-9]{1,128}$

Example:

"eip155:8453:0x1234567890abcdef1234567890abcdef12345678"