🔍 Orders & Requery API
Check the status of your orders and requery transactions. Useful when you receive a "processing" status or need to verify a transaction.
📚 Available Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /orders/:request_id |
Get order details by your request_id |
| POST | /requery |
Requery order status |
📋 Get Order by Request ID
cURL
curl -X GET "https://iacafe.com.ng/devapi/v1/orders/air_mtn_1704067200_abc123" \ -H "Authorization: Bearer YOUR_API_KEY"
🔄 Requery Order
cURL
curl -X POST "https://iacafe.com.ng/devapi/v1/requery" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_id": "elec_ikeja_1704067200_xyz"
}'
When to Use Requery
Use requery when:
• You received status
• Your webhook didn't fire
• You need to manually verify a transaction
• You received status
processing-api• Your webhook didn't fire
• You need to manually verify a transaction
📤 Response Example
Success Response
{
"code": "success",
"message": "ORDER COMPLETED",
"data": {
"order_id": 355960,
"status": "completed-api",
"product_name": "Airtime",
"service_name": "MTN",
"customer_id": "08012345678",
"amount": 100,
"amount_charged": "97.80",
"discount": "2.20",
"request_id": "air_mtn_1704067200_abc123",
"date_created": "2024-01-01T10:00:00Z"
}
}
📊 Order Statuses
| Status | Description | Action |
|---|---|---|
| completed-api | Order completed successfully | Deliver to customer |
| processing-api | Order is being processed | Wait for webhook or requery |
| refunded-api | Order failed, wallet refunded | Inform customer, they can retry |