Skip to main content
GET
/
payments
Find payments
curl --request GET \
  --url https://sandbox-api.paynext.com/payments \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "amount": 15000,
      "amount_usd": 15000,
      "avs_check": {
        "result": {
          "postal_code": "pass",
          "street_address": "pass"
        }
      },
      "created_at": "2025-05-25T14:30:00Z",
      "customer": {
        "address": {
          "city": "San Francisco",
          "line1": "123 Market Street",
          "line2": "Suite 400",
          "postal_code": "94105",
          "state": "CA"
        },
        "created_at": "2025-05-28T14:00:00Z",
        "email": "alice.johnson@example.com",
        "external_id": "ext_001",
        "full_name": "Alice Johnson",
        "id": "cus_b8d0fe7e-3a7f-4b5f-a68b-d31358b49c3f",
        "metadata": {
          "key": "value"
        },
        "phone": "+1-555-123-4567",
        "updated_at": "2025-05-28T14:05:00Z"
      },
      "cvc_check": {
        "result": {
          "cvc": "pass"
        }
      },
      "id": "pay_e8a1b2c3-d4f5-6789-abcd-ef0123456789",
      "metadata": {
        "key": "value"
      },
      "payment_details": {
        "arn": "123453",
        "auth_code": "334385",
        "network_payment_id": "119676610486528",
        "processor_transaction_id": "pi_3RgN6TJVVBuowJOx0B4fpGWi"
      },
      "payment_method": {
        "details": {
          "bin": "411111",
          "bin_data": {
            "currency_code": "<string>",
            "description": "Chase Sapphire Preferred",
            "issuer": "Chase Bank"
          },
          "exp_month": 12,
          "exp_year": 2028,
          "is_network_tokenized": true,
          "last4": "1111",
          "number": "4111111111111111"
        },
        "billing_address": {
          "city": "San Francisco",
          "line1": "123 Market Street",
          "line2": "Suite 400",
          "postal_code": "94105",
          "state": "CA"
        }
      },
      "processor": {
        "description": "Stripe US",
        "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
        "processor_merchant_id": "12345678",
        "type": "STRIPE"
      },
      "refund": {
        "amount": 123,
        "amount_usd": 123,
        "created_at": "<string>",
        "processor_transaction_id": "<string>",
        "updated_at": "<string>"
      },
      "refunded_amount": 0,
      "statement_descriptor": "MY COMPANY",
      "status_reason": {
        "status": "declined",
        "status_reason": {
          "advice_code": "do_not_try_again",
          "message": "<string>"
        }
      },
      "subscription": {
        "created_at": "2025-05-26T10:00:00Z",
        "current_period_end": "<string>",
        "current_period_start": "<string>",
        "id": "sub_123e4567-e89b-12d3-a456-426614174000",
        "metadata": {
          "key": "value"
        },
        "next_billing_date": "2025-06-26T12:00:00Z",
        "past_due": {
          "attempt_count": 2,
          "max_attempts_count": 7
        },
        "plan": {
          "id": "price_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
          "interval": "days",
          "interval_count": 1,
          "name": "Pro Plan",
          "price": {
            "amount": 1999,
            "currency": "AED"
          },
          "tax": {
            "collect_tax": "<unknown>"
          },
          "trial_interval": "days",
          "trial_interval_count": 14,
          "trial_price": {
            "amount": 1999,
            "currency": "AED"
          },
          "type": "recurring"
        },
        "updated_at": "2025-05-27T10:00:00Z"
      },
      "tax": {
        "amount_subtotal": 123,
        "amount_subtotal_usd": 123,
        "amount_tax": 123,
        "amount_tax_usd": 123,
        "behavior": "<unknown>",
        "calculation_id": "<string>",
        "error": {
          "code": "<unknown>",
          "message": "<string>"
        },
        "provider": {
          "id": "<string>"
        },
        "status": "<unknown>",
        "transaction_id": "<string>"
      },
      "three_d_secure": {
        "authentication_flow": "<string>",
        "electronic_commerce_indicator": {
          "liability_shift": true,
          "result": "<string>",
          "value": "<string>"
        },
        "status_reason": "<string>",
        "transaction_id": "<string>",
        "version": "<string>"
      },
      "updated_at": "2025-05-26T10:15:00Z"
    }
  ],
  "meta": {
    "limit": 100,
    "page": 1,
    "pages": 1,
    "snapshot_at": "2026-01-01T00:00:00Z",
    "total": 1
  }
}

Authorizations

​
Authorization
string
header
required

Authentication header of the form api key, where api key is your organization api key.

Headers

​
X-API-Version
enum<string>

Specifies the version of the API to use

Available options:
1.0.0

Query Parameters

​
amount_from
integer

Minimum payment amount

​
amount_to
integer

Maximum payment amount

​
currency_code
enum<string>

ISO currency code (e.g., USD, EUR)

Available options:
AED,
AFN,
ALL,
AMD,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HTG,
HUF,
IDR,
ILS,
IMP,
INR,
IQD,
IRR,
ISK,
JEP,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLE,
SOS,
SRD,
SSP,
STD,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
BOV,
COU,
CHE,
CHW,
MXV,
UGX,
VES,
VND,
VUV,
XAF,
XCD,
XCG,
XOF,
XPF,
YER,
USD
​
from
string

Start datetime filter (ISO 8601 format)

​
limit
integer
default:100

Number of items per page

Required range: 1 <= x <= 1000
​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
page
integer
default:1

Page number for paginated results

Required range: x >= 1
​
payment_status
enum<string>

Filter by payment status

Available options:
PENDING,
FAILED,
AUTHORIZED,
SETTLING,
SETTLED,
DECLINED,
BLOCKED,
CANCELLED
​
payment_status_in
enum<string>
Available options:
PENDING,
FAILED,
AUTHORIZED,
SETTLING,
SETTLED,
DECLINED,
BLOCKED,
CANCELLED
​
payment_status_not_in
enum<string>
Available options:
PENDING,
FAILED,
AUTHORIZED,
SETTLING,
SETTLED,
DECLINED,
BLOCKED,
CANCELLED
​
payment_status_set
string
​
search
string

Keyword to search across fields

​
snapshot_at
string

Timestamp of the data snapshot

​
sort
string
default:created_at

Field to sort by

​
statement_descriptor
string

Statement descriptor filter

​
to
string

End datetime filter (ISO 8601 format)

Response

OK

​
data
object[]
​
meta
object