v1

latestOpenAPI 3.1.02026-07-262343124.1 KB

Crypto Settlement

Create crypto settlements

Register one or more crypto settlement destinations for the merchant. Each entry pairs a CAIP-19 asset with a CAIP-10 destination wallet on the same chain. Each (merchant, asset) pair must be unique — registering the same asset twice returns settlement_asset_conflict.

post/v1/merchants/{merchantId}/settlements/crypto

Path parameters

merchantIdstring required

Headers

Idempotency-Keystring required

Unique key to ensure idempotent request processing. Max 255 characters.

Request body

Example request

{
  "settlements": [
    {
      "asset": "eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "destination": "eip155:8453:0x1234567890abcdef1234567890abcdef12345678"
    },
    {
      "asset": "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "destination": "eip155:1:0x1234567890abcdef1234567890abcdef12345678"
    }
  ]
}

Response

Crypto settlements created

Example response

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