Docs:Verify Payment
Query real-time transaction verification, settlement status, and gateway confirmation by Order ID.
Use this endpoint to query the real-time processing status of a transaction using its ZezoPay or gateway orderId. This endpoint is used for payment status polling, verification, and confirmation on client or server.
https://payapi.zezo.in/api/v1/payments/verify-payment/{orderId}| Parameter | Type | Required | Description |
|---|---|---|---|
orderId | string | Required | The unique order ID returned from the checkout session (e.g. `order_NX8aBz10Q1pLMq`). |
| Parameter | Type | Required | Description |
|---|---|---|---|
x-public-key | string | Required | Your Public Key. |
x-secret-key | string | Optional | Your Secret Key (optional when using public hybrid auth). |
Content-Type | string | Required | Payload encoding format. Default: application/json |
curl -X GET "https://payapi.zezo.in/api/v1/payments/verify-payment/order_NX8aBz10Q1pLMq" \
-H "x-public-key: zp_pub_xxxxxxxxxxxxxxxxxxxx" \
-H "x-secret-key: zp_sec_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"{
"status": true,
"paymentStatus": "success",
"orderId": "order_NX8aBz10Q1pLMq",
"provider": "razorpay"
}paymentStatus Values| Status | Description |
|---|---|
success | Payment captured and settled successfully. |
pending | Payment session initiated; awaiting customer auth or bank confirmation. |
failed | Payment declined, expired, or cancelled. |
Returned if the orderId does not exist in your account.
{
"type": "NotFoundError",
"status": 404,
"message": "Payment not found"
}