Skip to main content
GET
/
v1
/
merchants
/
payments
List payments for a merchant
curl --request GET \
  --url https://api.pay.walletconnect.com/v1/merchants/payments \
  --header 'Api-Key: <api-key>' \
  --header 'Merchant-Id: <merchant-id>'
{
  "data": [
    {
      "paymentId": "pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ",
      "merchant": {
        "id": "acme-store-1",
        "name": "Acme Store",
        "iconUrl": "https://imagedelivery.net/example/icon.png"
      },
      "referenceId": "a1b2cad4e5f2783012345678axcdea90",
      "status": "succeeded",
      "isTerminal": true,
      "fiatAmount": {
        "unit": "iso4217/USD",
        "value": "500",
        "display": {
          "assetSymbol": "USD",
          "assetName": "US Dollar",
          "decimals": 2
        }
      },
      "tokenAmount": {
        "unit": "caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000",
        "value": "5000000",
        "display": {
          "assetSymbol": "USDC",
          "assetName": "USD Coin",
          "decimals": 6,
          "networkName": "Base",
          "iconUrl": "https://api.walletconnect.com/assets/v1/image/token/USDC/md",
          "networkIconUrl": "https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"
        }
      },
      "buyer": {
        "accountCaip10": "eip155:8453:0x0000000000000000000000000000000000000000",
        "accountProviderName": "MetaMask",
        "accountProviderIcon": "https://api.walletconnect.com/assets/v1/image/wallet/metamask/md"
      },
      "transaction": {
        "networkId": "8453",
        "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "nonce": 42
      },
      "settlement": {
        "amount": {
          "unit": "caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000",
          "value": "4840000",
          "display": {
            "assetSymbol": "USDC",
            "assetName": "USD Coin",
            "decimals": 6,
            "iconUrl": "https://api.walletconnect.com/assets/v1/image/token/USDC/md",
            "networkName": "Base",
            "networkIconUrl": "https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"
          }
        },
        "settled": true,
        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
      },
      "fees": {
        "total": {
          "unit": "caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000",
          "value": "160000",
          "display": {
            "assetSymbol": "USDC",
            "assetName": "USD Coin",
            "decimals": 6,
            "iconUrl": "https://api.walletconnect.com/assets/v1/image/token/USDC/md",
            "networkName": "Base",
            "networkIconUrl": "https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"
          }
        },
        "fixed": {
          "unit": "caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000",
          "value": "140000",
          "display": {
            "assetSymbol": "USDC",
            "assetName": "USD Coin",
            "decimals": 6,
            "iconUrl": "https://api.walletconnect.com/assets/v1/image/token/USDC/md",
            "networkName": "Base",
            "networkIconUrl": "https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"
          }
        },
        "percentage": "0.4"
      },
      "createdAt": "2024-01-01T12:00:00.000Z",
      "lastUpdatedAt": "2024-01-01T12:00:00.000Z",
      "settledAt": "2024-01-01T12:00:00.000Z"
    }
  ],
  "nextCursor": null,
  "stats": {
    "totalRevenue": [
      {
        "amount": 1000,
        "currency": "USD"
      }
    ],
    "totalTransactions": 100,
    "totalCustomers": 25
  }
}

Authorizations

​
Api-Key
string
header
required

Headers

​
Merchant-Id
string
required

Merchant identifier.

Example:

"acme-store-1"

​
WCP-Version
string

Optional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.

Examples:

"2026-02-18"

"2026-02-19.preview"

Query Parameters

​
startTs
string

RFC3339 timestamp, inclusive

Example:

"2026-01-06T00:00:00Z"

​
endTs
string

RFC3339 timestamp, exclusive

Example:

"2026-01-07T00:00:00Z"

​
asset
string

Filter by CAIP-19 asset identifier. Comma-separated for multiple.

Example:

"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

​
network
string

Filter by CAIP-2 chain ID. Comma-separated for multiple.

Examples:

"eip155:8453"

"eip155:8453,eip155:1"

​
sortBy
enum<string>

Field to sort by

Available options:
date,
amount
​
sortDir
enum<string>

Sort direction

Available options:
asc,
desc
​
cursor
string

Opaque pagination cursor — use the value from nextCursor in the previous response.

​
limit
integer

Page size (default 50, max 200)

Required range: 1 <= x <= 200
​
status
enum<string>[]

Filter by payment status. Accepts a single value or multiple repeated params:

  • Single: ?status=succeeded
  • Multiple: ?status=succeeded&status=processing
Available options:
requires_action,
processing,
succeeded,
failed,
expired

Response

Payments with statistics

​
data
object[]
required
​
nextCursor
string | null
required

Cursor for the next page, or null if no more results

​
stats
object
required

Aggregate statistics for the query