GET /checkout/order-status

Poll payment state from your backend using the order id returned when you created the checkout session.

Same API host as create-order: <code>GET /checkout/order-status?orderId=YOUR_ORDER_ID</code> (lowercase routing).

Use the same Checkout API key from the merchant app (Settings → Checkout API key) in the <code>Api-Key</code> header on every request.

Only orders that belong to your merchant account return HTTP 200 with JSON. Unknown ids or another merchant’s orders return HTTP 404 with the same message so order ids cannot be enumerated across accounts.

Authentication

Header Api-Key: the same full secret key as for POST /checkout/order-from-product.

HTTP request

GET · query orderId · Api-Key

Sample request (illustrative)

GET /checkout/order-status?orderId=673f92b2c3d94a0012abcd01 HTTP/1.1
Host: api.zenofy.io
Api-Key: YOUR_CHECKOUT_API_KEY

Successful response

HTTP 200 with JSON: success, orderId, status (for example PENDING, PAID, CANCELLED, REFUNDED, EXPIRED), currency, totalAmount. Omitting orderId returns HTTP 400.

Sample response (HTTP 200)

{
  "success": true,
  "orderId": "673f92b2c3d94a0012abcd01",
  "status": "PAID",
  "currency": "MZN",
  "totalAmount": 149.99
}

Separate guide: create order from product (POST) →

All tutorials