Delivery for your platform, inside your own checkout.
Quote the fee, book the rider and show live tracking to your customers without leaving your site.
Two calls to go live. One webhook to keep your customers informed.
Price at checkout, create after payment, then listen. Every response is plain JSON, and every webhook is signed.
POST /api/v1/partner/deliveries/quote
Authorization: Bearer bxp_************
{
"parcel_category_id": 3,
"pickup": { "address": "12 Allen Avenue, Ikeja", "latitude": 6.6018, "longitude": 3.3515 },
"dropoff": { "address": "Maryland Mall, Ikeja", "latitude": 6.5700, "longitude": 3.3650,
"contact_name": "Bola", "contact_phone": "+2348098765432" }
}
200 OK
{ "fee": { "delivery_charge": 800.00, "service_charge": 100.00,
"tax": 67.50, "total": 967.50, "currency": "NGN" } }POST https://your-platform.example/webhooks/biteexpress
X-BiteExpress-Event: rider_assigned
X-BiteExpress-Signature: sha256=3f1c...
{
"event": "rider_assigned",
"status": "rider_assigned",
"delivery": {
"id": 100123,
"reference": "YOUR-ORDER-10293",
"rider": { "name": "Musa A.", "phone": "+234...", "latitude": 6.59, "longitude": 3.36 }
}
}How an order moves through BiteExpress
Your platform stays the front door. We handle the riders, the pricing and the status updates.
Quote
Send the pickup and drop-off. We return the fee in NGN so you can show it before the customer pays.
Create
After payment, create the delivery with your own order id. The fee leaves your prepaid wallet.
Dispatch
Riders in the pickup zone get the job on their app, the same as every other BiteExpress parcel.
Track
Poll the status endpoint or receive webhooks for every change, with the rider's live position.
Built for platforms that sell, not for couriers
Honest pricing
You pay what a customer would pay in the BiteExpress app, nothing marked up for the API.
Prepaid, never cash
One wallet per partner. No cash on delivery, no rider collecting money from your customer.
The same riders
Your deliveries ride the network that already serves BiteExpress restaurants and stores.
Live rider position
Rider name, phone and location in every status response while the delivery is active.
Signed webhooks
Every status change is posted to your endpoint with an HMAC signature and retries.
Safe to retry
Creates are idempotent on your order id, so a network retry never books or charges twice.
Tell us about your platform
We reply with pricing for your volume, a staging key and the integration guide.
- Reply within 2 business days.
- Staging credentials before anything goes live.
- A partnerships lead on the thread until you ship.
Questions platforms ask us
The same way a parcel sent from the BiteExpress app is priced: by distance band and parcel category, with any live surge included. The quote endpoint returns the exact fee, and the create response confirms what was charged.