---
title: "Create crypto settlements"
method: POST
path: "/v1/merchants/{merchantId}/settlements/crypto"
tags: ["Crypto Settlement"]
---

# Create crypto settlements

`POST /v1/merchants/{merchantId}/settlements/crypto`

Register one or more crypto settlement destinations for the merchant. Each entry pairs a [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) `asset` with a [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) `destination` wallet on the same chain. Each `(merchant, asset)` pair must be unique — registering the same asset twice returns `settlement_asset_conflict`.

## Path parameters

- `merchantId` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `settlements` object[], required — List of asset/destination pairs to register. Up to 50 entries per request.
    - `asset` string, required — [CAIP-19](https://chainagnostic.org/CAIPs/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`.
    - `destination` string, required — [CAIP-10](https://chainagnostic.org/CAIPs/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`.

## Response `201`

Crypto settlements created

- object
  - `settlements` object[], required
    - `id` string, required — Crypto settlement ID
    - `asset` string, required — [CAIP-19](https://chainagnostic.org/CAIPs/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`.
    - `destination` string, required — [CAIP-10](https://chainagnostic.org/CAIPs/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`.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Merchant not found
- `409` — Conflict

---

[API](https://skmtc.net/walletconnect/apis/walletconnect-pay-api.md) · [All operations](https://skmtc.net/walletconnect/apis/walletconnect-pay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/walletconnect/walletconnect-pay-api/versions/8e5708191dde/schema)