Skip to content
Cartflox

Check the status of a session

Check the state of a session at any time, for example when the customer returns to success_url or to catch up on a missed webhook.

GET/v1/checkout/sessions/{id}/statusCurrent status of the session
curl
curl https://cartflox.com/api/v1/checkout/sessions/cmf3k2p1x0001abcd9e8f7g6h/status \
  -H "Authorization: Bearer af_live_sec_YOUR_KEY"
200 OK
{
  "id": "cmf3k2p1x0001abcd9e8f7g6h",
  "status": "SUCCESS",
  "paid": true,
  "amount": 5000,
  "currency": "XOF",
  "order_id": "CS-MF3K2A-9X1QZ",
  "provider": "PayDunya",
  "provider_reference": "pd_7f3a9c"
}

Possible statuses

Section titled “Possible statuses”
Status Meaning
PENDING Session created, payment not confirmed yet (customer on the page, OTP pending, redirect in progress…)
SUCCESS Payment confirmed by the aggregator. The paid field is true.
FAILED Payment declined or failed at the operator. The customer can retry on the same session.
CANCELLED Session cancelled, no longer payable.
REFUNDED Payment refunded from the dashboard.