TidePay
Payments

List payments

GET
/payments
X-API-Key<token>

Your merchant API key, shown once at creation in the dashboard (Settings → API key).

In: header

Query Parameters

status?string

Value in

  • "pending"
  • "pulled"
  • "settled"
  • "failed"
  • "canceled"
source?string

Filter to direct charges and one-time offer checkouts ("one_time") or recurring billing cycles ("subscription"). Omit for both.

Value in

  • "one_time"
  • "subscription"
customerId?string
subscriptionId?string
offerId?string
limit?integer

Max 100, default 20.

start?integer

Offset for pagination, default 0.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/payments"
{  "payments": [    {      "id": "pay_01j8x2q3r4s5t6u7v8w9x0y1z2",      "merchantId": "string",      "customerId": "string",      "source": "one_time",      "subscriptionId": "string",      "offerId": "string",      "priceId": "string",      "periodStart": "2026-08-19T14:32:00.000Z",      "periodEnd": "2026-08-19T14:32:00.000Z",      "attempts": 1,      "idempotencyKey": "string",      "paymentMethod": "wallet_connect",      "fromWallet": "0x71c7656ec7ab88b098defb751b7401b5f6d8976",      "toWallet": "0x71c7656ec7ab88b098defb751b7401b5f6d8976",      "amount": "10.00",      "platformAmount": "10.00",      "merchantAmount": "10.00",      "tokenKey": "usdc-polygon",      "chainId": 137,      "pullTxHash": "string",      "forwardTxHash": "string",      "platformTransferTxHash": "string",      "distributeTxHash": "string",      "status": "pending",      "failureReason": "insufficient_allowance",      "isSandbox": true,      "affiliatePartnerId": "string",      "affiliateCommissionPct": "string",      "createdAt": "2026-08-19T14:32:00.000Z",      "updatedAt": "2026-08-19T14:32:00.000Z"    }  ],  "limit": 20,  "start": 0}