Sandbox Environment
The sandbox environment is a fully functional replica of the production API that lets you test your integration without creating real orders or incurring charges. Orders are simulated, webhooks fire instantly, and special "magic values" let you trigger specific delivery scenarios.
Sandbox API Key
Use the following test API key for all sandbox requests. This key is pre-provisioned and available to all partners during development.
X-API-Key: sandbox_key_test_1234567890Important: The sandbox base URL is https://sandbox.pathao.com. Make sure to switch to https://api.pathao.com when you go live.
Magic Test Values
Use these special phone numbers as the receiver_phone field to simulate different delivery outcomes. Each number triggers a predetermined scenario.
Test Phone Numbers
| Phone Number | Behavior |
|---|---|
01700000001 | Order completes successfully through all stages |
01700000002 | Driver assigned but never accepts (times out after 5 min) |
01700000003 | Order cancelled by driver after acceptance |
01700000004 | Delivery fails (rider cannot find address) |
01700000005 | Webhook delivery fails (simulates partner endpoint down) |
Test Coordinates
Use these coordinates when testing order creation. The sandbox validates that coordinates fall within serviceable areas, just like production.
Pickup Location
Banani, Dhaka (default sandbox pickup)
lat: 23.7937
lng: 90.4066
Dropoff Location
Dhanmondi, Dhaka (default sandbox dropoff)
lat: 23.7465
lng: 90.3762
Out of Area
Rajshahi (outside service area - triggers INVALID_COORDINATES)
lat: 24.3636
lng: 88.6241
Sandbox Limits
The sandbox has relaxed limits compared to production to make testing easier.
| Limit | Details |
|---|---|
| Rate Limit | 1000 requests/minute (relaxed for testing) |
| Order Retention | Sandbox orders are deleted after 24 hours |
| Webhook Delivery | Webhooks fire instantly (no real driver matching) |