Start
Qoene Delivery API v1.0.0
Delivery for your shop, built into your checkout.
Quote and book Qoene Express doorstep deliveries and Qoene Relay point-to-point parcels in Ghana, print labels, follow every parcel with clear milestones, and get signed webhooks when things change.
How an integration fits together
- Checkout. Your server asks for delivery options and prices, and the buyer picks one, including a Qoene Point for Relay.
- Order paid. Your server books the parcel (or adds the order to the order inbox and ships it from there) and prints the label.
- On the way. Your server receives signed webhooks and shows the buyer tracking milestones.
Start here
Getting startedCreate a Business account, get a TEST key and book your first simulated parcel in about five minutes.Node.js SDKInstall
@qoene/delivery: typed methods, safe retries, pagination and webhook verification.Reference integrationA runnable shop backend: quote, book, label and a webhook receiver.API reference51 operations with request, response and error tables and examples in four languages.The basics
| Base URL | https://api.qoenedelivery.com/v1 |
| Authentication | Authorization: Bearer <key> with a qd_test_… or qd_live_… key |
| Format | JSON in and out. Success: { "status": "success", "data": … }. Error: { "status": "error", "message", "code"?, "details"? } |
| Money | Integer pesewas (2500 = GH₵ 25.00) |
| Retries | Creating calls take an Idempotency-Key; repeat the key to retry safely |
| Machine-readable spec | OpenAPI 3.1 document |
Products you can book
| Code | Product | Journey |
|---|---|---|
EXPRESS_STANDARD | Qoene Express Standard | Doorstep pickup to doorstep delivery |
EXPRESS_PRIORITY | Qoene Express Priority | Faster doorstep to doorstep |
RELAY_POINT | Qoene Relay Point | Drop off at a Qoene Point; the buyer collects at another |
RELAY_LOCKER | Qoene Relay Locker | Collection from a locker (once lockers are live) |
RELAY_HOME | Qoene Relay Home | Home delivery from the destination hub: one attempt, then the fallback Qoene Point chosen at booking |
Which of these your Business can use depends on your contract. GET /services lists them with their size limits and delivery promise.