Skip to main content
PATCH
https://api-sandbox.pavewaygroup.com/v1
/
payment-verification
/
{reference}
/
verify
Check Payment Status
curl --request PATCH \
  --url https://api-sandbox.pavewaygroup.com/v1/payment-verification/{reference}/verify \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "data": {
    "id": "658dc...",
    "status": "succeeded",
    "amount": "10000",
    "currency": "XAF",
    "created_at": "2024-01-01T12:00:00Z"
  }
}
Use this endpoint to poll the current status of a PaymentIntent. It is optimized for high-frequency polling from frontends or mobile apps while a customer is completing a payment.

​
Path Parameters

​
reference
string
required
The payment_ref or the merchant_reference of the PaymentIntent to check.

​
Response

Returns the current status and basic transaction info.
​
status
string
The current status: requires_action, processing, succeeded, failed, canceled.
​
amount
string
The transaction amount.
​
currency
string
The currency code.
​
id
string
The unique transaction ID.
{
  "status": "success",
  "data": {
    "id": "658dc...",
    "status": "succeeded",
    "amount": "10000",
    "currency": "XAF",
    "created_at": "2024-01-01T12:00:00Z"
  }
}