---
title: "List payin transactions"
method: GET
path: "/pay/transactions"
tags: ["Payins"]
---

# List payin transactions

`GET /pay/transactions`

Retrieves a paginated list of pay transactions for the authenticated platform.
Results can be filtered by participant, asset, deposit status, and timestamps.
Each deposit also emits a `crypto_pay_status_changed` webhook when it settles or fails.

**Note:** Some filtering capabilities may not be available for all platforms. Contact support if you need access to additional filters.

## Query parameters

- `participant_code` string
- `transaction_id` string
- `client_reference_id` string
- `pay_asset` string
- `deposit_address` string
- `success` 'true' | 'false'
- `page` string
- `page_size` string
- `deposit_timestamp_gte` string
- `deposit_timestamp_gt` string
- `deposit_timestamp_lt` string
- `deposit_timestamp_lte` string
- `merchant_participant_code` string

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

List of pay transactions with pagination metadata

- GetPayTransactionsResponse
  - `message` PayTransaction[] — Array of pay transactions
    - `participant_code` string — The shopper participant code.
    - `pay_asset` string — Cryptocurrency asset being paid with (e.g., BTC, ETH, USDC).
    - `rate` string — Conversion rate applied at execution time.
    - `quoted_currency` string — Fiat currency for the payment.
    - `source_address` string — Sender's wallet address that originated the deposit.
    - `deposit_address` string — Wallet address where the crypto was sent.
    - `quantity` string — Crypto quantity deposited.
    - `notional` string — Fiat value of the deposit in `quoted_currency`.
    - `success` boolean — Whether the payment completed successfully.
    - `status_reason` string — Human-readable failure reason. Empty string if successful.
    - `status_reason_code` string — Machine-readable code describing the outcome of the payment. Examples: `DEPOSIT_PROCESSED`, `AMOUNT_ABOVE_MAXIMUM`, `AMOUNT_BELOW_MINIMUM`.
    - `fund_timestamp` number — Unix timestamp in milliseconds indicating when the payment quote was created.
    - `deposit_timestamp` number — Unix timestamp in milliseconds indicating when the blockchain deposit was detected.
    - `transaction_id` string — On-chain transaction identifier associated with the deposit.
    - `account_label` string — The account label that received the payment. Defaults to `pay` for pay transactions.
    - `fund_id` string, uuid — zerohash-generated unique identifier for this payment event.
    - `is_first_deposit` boolean — Indicates whether this was the participant's first deposit (used for first-deposit fee treatment).
    - `raw_fee_bps` string — Initial fee rate expressed in basis points.
    - `deposit_fee_bps` string — Effective fee rate in basis points that was actually applied after any minimum floors were considered.
    - `raw_fee_notional` string — Initial fee amount calculated directly from `raw_fee_bps`, in `quoted_currency`.
    - `deposit_fee_notional` string — Final fee amount actually charged to the participant, in `quoted_currency`.
    - `deposited_asset` string — Actual asset deposited on-chain. May differ from `pay_asset` when cross-chain fallback occurred.
    - `reference_id` string — The client-provided reference identifier for this payment, or empty string if none was supplied.
    - `source` PayTransactionSource — Source of the auth transaction. Only present if Auth Embedded is enabled for the platform.
      - `type` 'CUSTODIAL' | 'NON_CUSTODIAL' | 'MANUAL' — Type of transaction source.
      - `integration` string — Integration identifier (if applicable).
    - `deposit_fee_type` 'flat' | 'tiered' — The fee model applied to this transaction.
    - `fee_tier_breakdown` PayFeeTierBreakdown[] — Breakdown of how the fee was calculated across tiers. Only present when `deposit_fee_type` is `tiered`.
      - `tier` number — The tier number (1-based).
      - `amount_in_tier` string — The deposit amount that fell into this tier.
      - `fee_bps` string — The fee rate in basis points applied for this tier.
      - `fee_amount` string — The fee amount calculated for this tier.
    - `merchant_participant_code` string — The merchant participant code associated with this payment. Only present when a merchant is linked to the transaction.
  - `page` integer — Current page number (1-indexed)
  - `page_size` integer — Number of items per page (capped at 50)
  - `total_pages` integer — Total number of pages available

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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