Check Deposit Status
Query the status of a deposit transaction at any time using its reference.
Endpoint
GET /api/v2/deposit/status/{reference}
Sandbox Example
curl -X GET "https://sandbox.awdpay.com/test/api/v2/deposit/status/DEP_TEST_1763646304918_1D05265E" \
-H "Authorization: Bearer $AWDPAY_TOKEN"
Response
{
"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": "Premium subscription"
}
}
Status Values
| Status | Description |
|---|---|
pending | Transaction initiated, awaiting payment |
processing | Payment in progress |
completed | Payment successful |
failed | Payment failed |
expired | Transaction expired before completion |
cancelled | Cancelled by user or merchant |
Use Cases
- Order confirmation: verify payment before delivering service
- Customer support: check transaction history
- Reconciliation: sync external systems with AWDPay state
Best Practice
Always verify deposit status via this endpoint before finalizing orders, especially if webhook delivery is delayed or fails.