v1

latestOpenAPI 3.1.02026-07-262343124.1 KB

Payments

List payments

Retrieve paginated payments with optional filters.

get/v1/payments

Query parameters

startTsstring date-time

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

RFC3339 timestamp, inclusive

endTsstring date-time

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

RFC3339 timestamp, exclusive

token_symbolstring[]

Filter by token symbol (e.g. USDC). CAIP-19 identifiers are not supported. Accepts a single value or multiple repeated params:

Single: ?token_symbol=USDC
Multiple: ?token_symbol=USDC&token_symbol=EURC

assetstring

Deprecated. This parameter will be removed in a future API version. Use token_symbol param instead.

networkstring

Example:eip155:8453

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

sortBy'date' | 'amount'

Field to sort by

sortDir'asc' | 'desc'

Sort direction

cursorstring

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

limitinteger

Page size (default 50, max 200)

statusstring[]

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

Single: ?status=succeeded
Multiple: ?status=succeeded&status=processing

referenceIdstring

Example:order-42

Substring search on the merchant-provided reference ID. Between 3 and 35 characters. Allowed characters: ASCII letters, digits, and /-:.,+.

merchantIdstring[]

Filter by merchant ID. Accepts a single value or multiple repeated params:

Single: ?merchantId=acme-store-1
Multiple: ?merchantId=acme-store-1&merchantId=widget_co

[
  "acme-store-1"
]

Headers

WCP-Versionstring

Example:2026-02-18

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

Response

Payments with statistics

nextCursorstring nullable required

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

Example response

{
  "data": [
    {
      "buyer": {
        "accountCaip10": "eip155:8453:0x1234567890abcdef1234567890abcdef12345678",
        "accountProviderName": "MetaMask"
      },
      "transaction": {
        "networkId": "8453"
      }
    }
  ],
  "stats": {
    "totalRevenue": [
      {
        "currency": "USD"
      }
    ]
  }
}