POST /payment/list

Returns a paginated list of payments. Requires authentication.

Request

POST /payment/list

Request Body

Field	Type	Required	Description
date_from	string	No	Filter from date (ISO 8601)
date_to	string	No	Filter to date (ISO 8601)

Example

# Compute sign: MD5(base64(JSON.stringify(body)) + API_KEY)
curl -X POST https://api.nearpayments.io/cryptomus/v1/payment/list \
  -H "Content-Type: application/json" \
  -H "merchant: YOUR_MERCHANT_UUID" \
  -H "sign: COMPUTED_SIGN" \
  -d '{
    "date_from": "2025-01-01T00:00:00.000Z",
    "date_to": "2025-01-31T23:59:59.000Z"
  }'

Response

{
  "state": 0,
  "result": {
    "items": [
      {
        "uuid": "a1b2c3d4-...",
        "order_id": "order-42",
        "amount": "50.00",
        "payment_amount": "50.00",
        "payer_amount": "50.00",
        "discount_percent": 0,
        "discount": "0.00",
        "payer_currency": "USDT",
        "currency": "USDT",
        "merchant_amount": "49.50",
        "network": "tron",
        "address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
        "from": "TXyz...",
        "txid": "abc123...",
        "payment_status": "finished",
        "url": "https://api.nearpayments.io/pay/a1b2c3d4-...",
        "expired_at": 1710600000,
        "status": "paid",
        "is_final": true,
        "additional_data": null,
        "created_at": "2025-01-15T10:30:00+00:00",
        "updated_at": "2025-01-15T10:35:00+00:00"
      }
    ],
    "paginate": {
      "count": 1,
      "hasPages": false,
      "nextCursor": null,
      "previousCursor": null,
      "perPage": 15
    }
  }
}