Skip to main content
GET
/
payments
/
{id}
Find a payment
curl --request GET \
  --url https://sandbox-api.paynext.com/payments/{id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "payment",
  "id": "pay_e8a1b2c3-d4f5-6789-abcd-ef0123456789",
  "amount": 15000,
  "amount_usd": 15000,
  "currency_code": "USD",
  "payment_status": "SETTLED",
  "payment_type": "CIT",
  "payment_token_type": "CARD_PAN",
  "refunded_amount": 0,
  "statement_descriptor": "ACME CORP",
  "created_at": "2025-05-25T14:30:00Z",
  "updated_at": "2025-05-26T10:15:00Z",
  "metadata": {
    "order_id": "ORD-12345"
  },
  "customer": {
    "id": "cus_b8d0fe7e-3a7f-4b5f-a68b-d31358b49c3f",
    "email": "alice.johnson@example.com",
    "external_id": "ext_001",
    "full_name": "Alice Johnson",
    "phone": "+1-555-123-4567",
    "created_at": "2025-05-28T14:00:00Z",
    "updated_at": "2025-05-28T14:05:00Z",
    "metadata": {
      "key": "value"
    },
    "address": {
      "city": "San Francisco",
      "country": "US",
      "line1": "123 Market Street",
      "line2": "Suite 400",
      "postal_code": "94105",
      "state": "CA"
    }
  },
  "payment_method": {
    "type": "CARD",
    "billing_address": {
      "city": "San Francisco",
      "country": "US",
      "line1": "123 Market Street",
      "line2": "Suite 400",
      "postal_code": "94105",
      "state": "CA"
    },
    "details": {
      "bin": "411111",
      "last4": "1111",
      "exp_month": 12,
      "exp_year": 2028,
      "is_network_tokenized": true,
      "number": "4111111111111111",
      "bin_data": {
        "brand": "visa",
        "country": "US",
        "currency_code": "USD",
        "description": "Chase Sapphire Preferred",
        "funding": "credit",
        "issuer": "Chase Bank",
        "type": "consumer"
      }
    }
  },
  "payment_details": {
    "arn": "74922051234567",
    "auth_code": "334385",
    "network_payment_id": "119676610486528",
    "processor_transaction_id": "pi_3RgN6TJVVBuowJOx0B4fpGWi"
  },
  "processor": {
    "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "description": "Stripe US",
    "type": "STRIPE",
    "processor_merchant_id": "12345678"
  },
  "subscription": {
    "id": "sub_123e4567-e89b-12d3-a456-426614174000",
    "status": "active",
    "created_at": "2025-05-26T10:00:00Z",
    "updated_at": "2025-05-27T10:00:00Z",
    "current_period_start": "2025-05-26T10:00:00Z",
    "current_period_end": "2025-06-26T10:00:00Z",
    "next_billing_date": "2025-06-26T12:00:00Z",
    "past_due": {
      "attempt_count": 0,
      "max_attempts_count": 7
    },
    "plan": {
      "id": "price_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "name": "Pro Plan",
      "type": "recurring",
      "interval": "months",
      "interval_count": 1,
      "trial_interval": "days",
      "trial_interval_count": 14,
      "price": {
        "amount": 1999,
        "currency": "USD"
      },
      "trial_price": {
        "amount": 0,
        "currency": "USD"
      },
      "tax": {
        "collect_tax": "DEFAULT"
      }
    },
    "metadata": {}
  },
  "refund": {
    "amount": 0,
    "amount_usd": 0,
    "status": "PENDING",
    "created_at": "2025-05-26T10:15:00Z",
    "updated_at": "2025-05-26T10:15:00Z",
    "processor_transaction_id": ""
  },
  "avs_check": {
    "result": {
      "postal_code": "pass",
      "street_address": "pass"
    }
  },
  "cvc_check": {
    "result": {
      "cvc": "pass"
    }
  },
  "tax": {
    "amount_subtotal": 15000,
    "amount_subtotal_usd": 15000,
    "amount_tax": 0,
    "amount_tax_usd": 0,
    "behavior": "EXCLUSIVE",
    "status": "calculated",
    "provider": {
      "id": "numeral",
      "type": "NUMERAL"
    },
    "calculation_id": "calc_123",
    "transaction_id": "tx_123"
  },
  "three_d_secure": {
    "authentication_flow": "challenge",
    "status": "success",
    "version": "2.2.0",
    "transaction_id": "3ds_123",
    "electronic_commerce_indicator": {
      "liability_shift": true,
      "result": "pass",
      "value": "05"
    }
  },
  "status_reason": {
    "status": "declined",
    "status_reason": {
      "advice_code": "do_not_try_again",
      "decline_code": "insufficient_funds",
      "message": "Card has insufficient funds"
    }
  }
}

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:
2.0.0

Path Parameters

​
id
string
required

The ID of the payment to find

Response

Returns the payment object if a valid identifier was provided.

​
id
string

Unique identifier of the payment.

Example:

"pay_e8a1b2c3-d4f5-6789-abcd-ef0123456789"

​
fraud_prevention
object

Fraud-prevention signals recorded against the payment by upstream Visa / Verifi / Mastercard notification flows (Visa Order Insight, Verifi Compelling Evidence (CE 3.0), Visa Rapid Dispute Resolution (RDR), Early Fraud Warning, Mastercard Consumer Clarity). Omitted when no signals have been recorded yet.

​
payment_attempts
object[] | null

Chronological list of processor attempts made for this payment. Populated when payment routing cascades across multiple processors; each entry records the processor used and its outcome.

​
amount
integer

Payment amount in the specified currency (e.g., cents)

Example:

15000

​
amount_usd
integer

Payment amount converted to USD (e.g., cents)

Example:

15000

​
avs_check
object

Avs check

​
currency_code
enum<string>

The 3-letter currency code in ISO 4217 format. e.g. use USD for US dollars.

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
​
customer
object
​
cvc_check
object

CVC check

​
payment_details
object

Transaction details related to payment

​
payment_method
Card API Schema · object
​
payment_status
enum<string>

Current status of the payment

Available options:
PENDING,
FAILED,
AUTHORIZED,
SETTLING,
SETTLED,
DECLINED,
BLOCKED,
CANCELLED
​
payment_token_type
enum<string>

Type of card token used, if applicable

Available options:
CARD_PAN,
NETWORK_TOKEN,
PROCESSOR_TOKEN
​
payment_type
enum<string>

Indicates whether the transaction was merchant-initiated (MIT) or customer-initiated (CIT).

Available options:
MIT,
CIT
​
processor
object
​
refund
object

Information about refund

​
refunded_amount
integer

Amount refunded from the original payment

Example:

0

​
statement_descriptor
string

Statement descriptor shown on the customer's bank statement

Example:

"MY COMPANY"

​
status_reason
object

Reason of payment status

​
subscription
object
​
tax
object

Tax info (provider, calculation/transaction ids, amounts, status)

​
three_d_secure
object

Information about 3DS

​
metadata
object

Custom metadata associated with the payment A dictionary of key-value pairs.

Example:
{ "key": "value" }
​
created_at
string

The date and time at which the payment was created in UTC format.

Example:

"2025-05-25T14:30:00Z"

​
updated_at
string

The date and time of the last payment update in UTC format.

Example:

"2025-05-26T10:15:00Z"