Vérifier le Statut d'un Dépôt
Interrogez le statut d'une transaction de dépôt à tout moment en utilisant sa référence.
Endpoint
GET /api/v2/deposit/status/{reference}
Exemple Sandbox
curl -X GET "https://sandbox.awdpay.com/test/api/v2/deposit/status/DEP_TEST_1763646304918_1D05265E" \
-H "Authorization: Bearer $AWDPAY_TOKEN"
Réponse
{
"reference": "DEP_TEST_1763646304918_1D05265E",
"status": "completed",
"amount": 10000.0,
"currency": "XOF",
"fees": 104.0,
"gatewayName": "wave-senegal",
"customerEmail": "customer@example.com",
"customerPhone": "+221701234567",
"customerName": "Awa Diop",
"createdAt": "2025-11-20T14:45:04",
"completedAt": "2025-11-20T14:47:32",
"metadata": {
"order_id": "ORDER_123",
"description": "Abonnement premium"
}
}
Valeurs de Statut
| Statut | Description |
|---|---|
pending | Transaction initiée, en attente de paiement |
processing | Paiement en cours |
completed | Paiement réussi |
failed | Paiement échoué |
expired | Transaction expirée avant finalisation |
cancelled | Annulée par l'utilisateur ou le marchand |
Cas d'Usage
- Confirmation de commande : vérifier le paiement avant de livrer le service
- Support client : consulter l'historique des transactions
- Rapprochement : synchroniser les systèmes externes avec l'état AWDPay
Meilleure Pratique
Vérifiez toujours le statut du dépôt via cet endpoint avant de finaliser les commandes, surtout si la livraison du webhook est retardée ou échoue.