/find_payments

post

https://api.paynearme-sandbox.com/json-api/find_payments

A dedicated endpoint for retrieving an order's payment history with explicit control over sorting, limiting, and pagination. This endpoint allows clients to retrieve a list of payments for a specific order directly via the site_order_identifier or the pnm_order_identifier or for a specific customer directly via the pnm_customer_identifier or the site_customer_identifier. This endpoint is only for returning regular consumer payments and not disbursements (use the /find_disbursements endpoint for push payments).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
Platform Limits
A system-wide maximum limit may be enforced regardless of the limit parameter provided (configurable per environment). Consult your PayNearMe Technical Account Manager for more information.

📘
Cross Referencing Identifiers
All payment responses include order (pnm_order_identifier and site_order_identifier) and customer (pnm_customer_identifier and site_customer_identifier) identifiers at the payment level for cross-referencing.

Body Params

Retrieves the payment history for a specific order or customer.

pnm_order_identifier

string

required

The unique, PayNearMe-defined identifier for this order.

site_identifier

string

required

Defaults to S2411573363

Identifies your client site.

timestamp

string

required

The Unix Epoch time of the call

version

string

required

Defaults to 3.0

The version of the API. This version must match the version associated with your API key pair.

signature

string

required

The HMAC signature that is calculated by running your API Secret Key and the alphabetized, concatenated parameters of the request payload through the SHA256 message digest algorithm.

site_order_identifier

string

An arbitrary string that the client uses to refer to an order.

pnm_customer_identifier

string

A unique PNM-defined ID for the consumer..

site_customer_identifier

string

A unique, client-defined ID for the consumer.

sort

string

enum

Defaults to desc

Sort direction: 'asc' (oldest first) or 'desc' (newest first). Default: 'desc'

Allowed:

limit

integer

Used for pagination, this parameter specifies the maximum number of payments to return. Default value is 10.

offset

integer

Used for pagination, this parameter specifies the number of payments to skip within the response. Default value is 0.

start_date

date

Filter payments on or after this date (YYYY-MM-DD)

end_date

date

Filter payments on or before this date (YYYY-MM-DD)

Response

Platform Limits

Cross Referencing Identifiers

201Payments Found