---
title: "Get payments for a merchant"
method: GET
path: "/v1/merchants/{merchant_id}/payments"
tags: ["Payments"]
deprecated: true
---

# Get payments for a merchant

`GET /v1/merchants/{merchant_id}/payments`

> **Deprecated.**

**Deprecated:** Use `GET /v1/merchants/payments` with partner `api-key` and `merchant-id` headers instead.

Retrieve paginated payments with optional filters.

## Path parameters

- `merchant_id` string, required

## Query parameters

- `start_ts` string, date-time
- `end_ts` string, date-time
- `asset` string
- `network` string
- `sort_by` 'date' | 'amount'
- `sort_dir` 'asc' | 'desc'
- `cursor` string
- `limit` integer
- `status` union
  - 'requires_action' | 'processing' | 'succeeded' | 'failed' | 'expired'
  - string[]

## Response `200`

Payments with statistics

- MerchantLegacyPaymentsResponse
  - `data` object[], required
    - `payment_id` string, required
    - `merchant_id` string, required
    - `reference_id` string, required
    - `status` 'requires_action' | 'processing' | 'succeeded' | 'failed' | 'expired', required
    - `is_terminal` boolean, required
    - `wallet_name` string, required
    - `chain_id` string, nullable
    - `buyer_caip10` string, nullable
    - `token_caip19` string, nullable
    - `tx_hash` string, nullable
    - `nonce` integer, nullable
    - `token_amount` string, nullable
    - `fiat_amount` integer, nullable
    - `fiat_currency` string, nullable
    - `created_at` string, nullable
    - `last_updated_at` string, nullable
    - `settled_at` string, nullable
    - `settlement_status` string, nullable
    - `settlement_tx_hash` string, nullable
    - `token_symbol` string, nullable, required
    - `token_decimals` integer, nullable, required
    - `token_logo` string, nullable, required
    - `chain_logo` string, nullable, required
    - `wallet_logo` string, nullable, required
  - `next_cursor` string, nullable
  - `stats` object, required
    - `total_customers` integer, required
    - `total_revenue` object, required
      - `amount` number, required
      - `currency` string, required
    - `total_transactions` integer, required

## Other responses

- `400` — Bad request — invalid parameters
- `401` — Unauthorized — missing or invalid API key
- `500` — Internal server error
- `502` — Bad gateway — upstream service returned an error

---

[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/revisions/8e5708191dde/schema)