Aller au contenu

Vérifier le statut d'une session

Interrogez l’état d’une session à tout moment, par exemple au retour du client sur success_url ou pour rattraper un webhook manqué.

GET/v1/checkout/sessions/{id}/statusStatut courant de la session
curl
curl https://cartflox.com/api/v1/checkout/sessions/cmf3k2p1x0001abcd9e8f7g6h/status \
-H "Authorization: Bearer af_live_sec_VOTRE_CLE"
200 OK
{
"id": "cmf3k2p1x0001abcd9e8f7g6h",
"status": "SUCCESS",
"paid": true,
"amount": 5000,
"currency": "XOF",
"order_id": "CS-MF3K2A-9X1QZ",
"provider": "PayDunya",
"provider_reference": "pd_7f3a9c"
}
Statut Signification
PENDING Session créée, paiement pas encore confirmé (client sur la page, OTP en attente, redirection en cours…)
SUCCESS Paiement confirmé par l’agrégateur. Le champ paid vaut true.
FAILED Paiement refusé ou échoué chez l’opérateur. Le client peut réessayer sur la même session.
CANCELLED Session annulée, plus payable.
REFUNDED Paiement remboursé depuis le tableau de bord.