Vérifier le statut d'une transaction
Utilisez cet endpoint pour vérifier le statut d'une transaction à tout moment avec sa référence.
Endpoint
GET
https://api.openpay-cg.com/v1/transaction/status/:referenceIdParamètres de l'URL
| Paramètre | Type | Description |
|---|---|---|
| referenceId | string | Référence de la transaction retournée lors de la création |
referenceIdstringRéférence de la transaction retournée lors de la création
Exemples de requête
cURL
cURL
curl -X GET https://api.openpay-cg.com/v1/transaction/status/PTXN26042237B99A5D9 \
-H "XO-API-KEY: YOUR_API_KEY" \
-H "Accept: application/json"Node.js (Axios)
Node.js
axios.get(
`https://api.openpay-cg.com/v1/transaction/status/${referenceId}`,
{
headers: {
'XO-API-KEY': process.env.OPENPAY_API_KEY,
'Accept': 'application/json'
}
}
)Réponse de succès
JSON200 OK
{
"reference": "PTXN26042237B99A5D9",
"amount": "10000",
"currency": "XAF",
"paymentPhoneNumber": "242066203420",
"provider": "MTN",
"type": "payment",
"status": "success",
"metadata": {
"order_id": "123456"
},
"createdAt": "2026-02-11T10:30:00.000Z",
"updatedAt": "2026-02-11T10:30:45.000Z"
}Statuts de transaction possibles
| Statut | Description | Action recommandée |
|---|---|---|
| pending | Transaction en cours de traitement | Vérifier à nouveau dans quelques secondes/minutes |
| success | Transaction réussie | Délivrer le service/produit au client |
| failed | Transaction échouée | Informer le client et proposer de réessayer |
| cancelled | Transaction annulée | Considérer comme non payée |
pending
Transaction en cours de traitement
→ Vérifier à nouveau dans quelques secondes/minutes
success
Transaction réussie
→ Délivrer le service/produit au client
failed
Transaction échouée
→ Informer le client et proposer de réessayer
cancelled
Transaction annulée
→ Considérer comme non payée