Dawurobo

Partner API · docs.dawurobo.com

Delivery, as an API.

One signed integration, one set of keys per app, every Dawurobo service: create and track deliveries from your own checkout, price a route first, pay from a prepaid wallet or on delivery, and receive signed webhooks. Sandbox keys in minutes, no sales call.

Read the docsllms.txt for the API
POST https://delivery.dawurobo.com/api/v1/delivery/orders.create
X-API-Key: pk_production_…
X-Signature: hmac-sha256(…)
X-Timestamp · X-Nonce

{
  "order_reference": "EXT-1001",
  "customer": { "name": "Ama Mensah", "phone": "0244000000" },
  "item": "1x parcel",
  "pickup": {
    "address": "Circle, Accra", "contact_person": "Kojo Shop",
    "contact_phone": "0209999999", "coordinates": { "lat": 5.5717, "lng": -0.2107 }
  },
  "delivery": {
    "address": "Adum", "city": "Kumasi", "region": "Ashanti",
    "coordinates": { "lat": 6.6919, "lng": -1.6236 }
  },
  "payment": { "payer": "partner" }
}

What you can call

The endpoints.

Delivery is the flagship; the Safe catalog lets you sell vetted vendors' products without holding stock. Full reference in the docs.

  • orders.createCreate a delivery from your checkout
  • orders.create_bulkCreate many in one call
  • orders.estimatePrice a route before you commit
  • orders.trackA status timeline for your customer
  • orders.cancelCancel while it is still cancellable
  • locations.listCities and towns we serve
  • wallet.balanceWhat is left to spend
  • wallet.topup.initiateTop up by mobile money or card
  • catalog.listSafe products you can resell

How it works

Sandbox today, production when your checks pass.

  1. 01

    Get a sandbox key

    Sign up in Partner Hub; a staging key is issued instantly.
  2. 02

    Sign your requests

    X-API-Key, X-Signature, X-Timestamp, X-Nonce on every call. Scopes decide what a key can do; money-moving scopes are never granted by wildcard.
  3. 03

    Build and test

    Create, estimate, track and cancel orders against staging. Staging orders are test orders: no rider, no SMS, no webhooks. Use Test webhook to check your endpoint.
  4. 04

    Go live

    Pass the Go live checks in Partner Hub and production is approved automatically. Then make live keys, and fund deliveries from your wallet or let the recipient pay on delivery.

Who it is for

Stores, platforms, resellers.

  • Online stores

    Offer delivery at checkout without running a fleet. Price the route, create the order, show the tracking.

  • Platforms and marketplaces

    One integration, one set of keys per app, every Dawurobo service your app is entitled to.

  • Resellers

    List a syndicated catalog of Safe vendors' products, take payment through the gateway, and let Dawurobo fulfil and settle.

Developers ask first.

How do I get API keys?

Sign up in Partner Hub and a sandbox key is issued instantly. Production is approved automatically once your app passes the Go live checks: business details, a live website, three sandbox orders, one order read back, and a webhook that accepts our signed test event and rejects a forged one.

How are requests signed?

Every request carries X-API-Key, X-Signature (HMAC), X-Timestamp and X-Nonce. Unsigned requests are refused. The docs include the signing steps and examples.

Is there a separate staging URL?

No. Staging and production share the same base URL; the key you use decides which environment you are in. Wallet and Safe-order endpoints refuse staging keys. Staging orders are never given to a rider and send no SMS or webhooks.

How do I pay for deliveries?

From a prepaid wallet you top up through the API, or cash on delivery collected from the recipient. Your account has one wallet, shared by all of its apps.

Do you send webhooks?

Yes, one for every status change and every rider assignment: received, accepted, rejected, picked up, in transit, delivered, cancelled, rescheduled, returned, returned to vendor, refunded, and updated for the other statuses. There is none when an order is created; the create response confirms it. They are HMAC-signed and retried up to five times. Sandbox keys send none.