Verify a payment order

Verify the status of any payment order created via initiate, checkout, or charge.

Endpoint

GET https://api-v3.reeple.ai/s2s/payments/verify/{reference}

Path parameters

Param	Type	Description
`reference`	String	Required. The reference of the payment order, e.g. `PSH_7A1B2C3D4E`.

Request example

curl -X GET https://api-v3.reeple.ai/s2s/payments/verify/PSH_7A1B2C3D4E \
  -H "public-key: YOUR_PUBLIC_KEY"

Response

{
  "success": true,
  "statusCode": 200,
  "message": "Payment order verified successfully",
  "data": {
    "status": "pending",
    "reference": "PSH_7A1B2C3D4E",
    "amount": 2500,
    "currency": "NGN"
  }
}

data.status is one of pending, success, or failed.

This is the same endpoint used in the callback verification flow.

A 400 on this endpoint specifically means the payment order wasn’t found.

See Errors for the shape of 401/500 responses.

Get Started

Bank Accounts

Bill Payments

Collections

Compliance

Customer

External Services

Gift Cards

Payment Links

Payouts

Refunds

S2S Payments

Transactions

Tuition

Verify a payment order

Endpoint

Path parameters

Request example

Response

​Endpoint

​Path parameters

​Request example

​Response

Endpoint

Path parameters

Request example

Response