UGO | Deliver lets a shop, a market stall or a software team order a local delivery from code: say where it starts, where it ends and who receives it, and get a price, a job number and a way for the sender to pay with mobile money. Riders take the jobs. The customer follows the delivery from a link.
Early access. The partner API and its sandbox are built and being tested. The rider app is next. We are not publishing prices yet: tell us what you want to send and where.
No courier company to call and no money to chase. Four steps, each one a clear status you can read.
Give the pickup and the drop-off, as a named junction or a map point. You get the distance and the fee before you commit to anything.
Add the parcel, a landmark at the door and the receiver's name and number. Your own reference makes the call safe to repeat: the same reference is always one job.
The job comes back with a payment link. The payer opens it, chooses MTN or Orange and approves on their own phone. Nothing starts until the fee has arrived.
The job goes to riders. The receiver gets a link to follow it and to confirm it arrived. If nobody takes it in time, or you cancel first, the fee goes back.
The same job looks different to each of them, and each sees only what they need.
Connect your shop, your booking system or your marketplace and order deliveries from it. Test everything with a sandbox key before a real franc moves.
An open list of jobs near you: see where it goes and what it pays, take it, deliver it, get paid to your own mobile-money number. The rider app is the next part we build.
No app and no account. A link in a message shows where the parcel is and lets you confirm it arrived, or say something is wrong, without calling anyone.
Plain JSON over HTTPS with one key in a header. You receive your endpoint address and a sandbox key when your access is approved.
# what would it cost?
curl "$DELIVER_URL/quote?pickup_lat=4.143&pickup_lng=9.259&dropoff_lat=4.118&dropoff_lng=9.239" \
-H "X-API-Key: $DELIVER_KEY"
# {"fee":1067,"distance_km_approx":3.56,"currency":"XAF"}
# order it
curl -X POST "$DELIVER_URL/jobs" \
-H "X-API-Key: $DELIVER_KEY" -H "Content-Type: application/json" \
-d '{"ref":"order-1042",
"pickup": {"lat":4.143,"lng":9.259,"label":"My shop"},
"dropoff": {"lat":4.118,"lng":9.239,"landmark":"Blue gate, next to the pharmacy",
"recipient_name":"Amina","recipient_phone":"677000111"},
"package": {"description":"A small parcel"},
"payment": {"mode":"pay_link"}}'
# {"job_id":"DLV-7K4Q","status":"pending_payment","fee":1067,"duplicate":false,"pay_url":"..."}$ch = curl_init(getenv('DELIVER_URL') . '/jobs');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-API-Key: ' . getenv('DELIVER_KEY')],
CURLOPT_POSTFIELDS => json_encode([
'ref' => 'order-1042', // the same ref twice is one job
'pickup' => ['lat' => 4.143, 'lng' => 9.259, 'label' => 'My shop'],
'dropoff' => ['lat' => 4.118, 'lng' => 9.239, 'landmark' => 'Blue gate',
'recipient_name' => 'Amina', 'recipient_phone' => '677000111'],
'package' => ['description' => 'A small parcel'],
'payment' => ['mode' => 'pay_link'],
]),
]);
$job = json_decode(curl_exec($ch), true); // $job['job_id'], $job['fee'], $job['pay_url']const headers = { 'Content-Type': 'application/json', 'X-API-Key': DELIVER_KEY };
const res = await fetch(`${DELIVER_URL}/jobs`, {
method: 'POST', headers,
body: JSON.stringify({
ref: 'order-1042',
pickup: { lat: 4.143, lng: 9.259, label: 'My shop' },
dropoff: { lat: 4.118, lng: 9.239, landmark: 'Blue gate', recipient_name: 'Amina', recipient_phone: '677000111' },
package: { description: 'A small parcel' },
payment: { mode: 'pay_link' },
}),
});
const { job_id, pay_url } = await res.json();
// later: where is it?
const r = await fetch(`${DELIVER_URL}/jobs/${job_id}`, { headers });
const { status } = await r.json(); // pending_payment, open, claimed, ... delivered| Call | What it does |
|---|---|
GET /quote | Distance and fee for two points |
POST /jobs | Create a delivery. Same ref twice is one job |
GET /jobs/{id} | The status of one of your jobs |
GET /jobs | Your jobs, by ref, status or date |
POST /jobs/{id}/cancel | Cancel while it is waiting; the fee goes back |
POST /sandbox/jobs/{id}/advance | Test keys only: move a test job to its next step |
A job is pending_payment, open, claimed, then picked up and delivered, or it ends expired or cancelled. Each key has its own scopes and a calls-per-minute limit.
Money, phone numbers and keys are the three things a delivery service must not get wrong.
Deliver never talks to a mobile-money operator itself. The fee is collected, and refunded when a job is cancelled or runs out of time, by UGO | Pay.
Your own reference is the key. A repeated call, a retry after a timeout or a double click returns the original job instead of making a second one.
The receiver's phone number lives apart from the job and is wiped after a retention period. The open list of jobs never shows it.
Each key does only what it was given, is stored in scrambled form, can be revoked in one click, and is rate-limited. A key is shown once, when it is made.
Test keys create test jobs that never touch money or riders, and can be walked through every status so you can build your screens first.
Every step is written down with who did it and when. Staff changes in the console are logged too, with the old and the new value.
Write to us with what you send, where from and to, and roughly how many a week. We reply on WhatsApp or by phone, and if it is a fit we set you up with a sandbox key first.
Something else? Contact us.