Add autonomous delivery to your marketplace checkout.
One API call during checkout returns a priced Yspace option. The customer pays you, we fulfil — your marketplace never touches a vehicle.
How it works
- Customer buys a productThe purchase happens in your marketplace checkout.
- Your marketplace requests a quoteSend Yspace pickup, dropoff, package, merchant and customer details.
- Yspace returns a delivery optionShow the estimated arrival, distance, price, currency and service level at checkout.
- Customer pays your marketplaceShopper payment stays entirely in your own checkout.
- You settle with YspaceYour marketplace pays Yspace by card per delivery or through an approved monthly invoice.
- Yspace operates the deliveryYspace fulfils the order and sends status updates for your tracking page.
What you get
A delivery option at checkout, without a delivery team
- — Live quotes at checkout, in a single request
- — Sandbox keys to test against before go-live
- — Test safely before requesting production access
- — Fulfilment handled end to end by Yspace
Prefer to read first?
The delivery-quote endpoint, its request shape and every error code are documented in API & Integrations.
Example checkout option
Yspace Express Delivery Estimated arrival: Today, 4:30 PM · Delivery fee: ₦X
Sample quote request
Pickup, dropoff, package, order, merchant, and customer data.
POST /v1/delivery/quote HTTP/1.1
Host: api.yspace.africa
Authorization: Bearer <YOUR_SANDBOX_KEY>
Content-Type: application/json
{
"pickup_location": { "lat": 6.4550, "lng": 3.3841 },
"dropoff_location": { "lat": 6.5244, "lng": 3.3792 },
"package_weight": 1.2,
"package_dimensions": { "length": 30, "width": 20, "height": 10 },
"package_category": "general",
"order_value": 48000,
"delivery_priority": "express",
"merchant_information": { "external_business_id": "merchant-1042", "external_store_id": "store-01" },
"customer_information": { "name": "Ada Example", "phone": "+2348000000000" }
}Sample quote response
A checkout option with delivery time, distance, price, and expiry.
HTTP/1.1 200 OK
Content-Type: application/json
{
"delivery_option": "Yspace Express Delivery",
"estimated_delivery_time": "Today, 4:30 PM",
"estimated_distance": 8.4,
"delivery_price": 2450,
"currency": "NGN",
"service_level": "express",
"quote_expiry": "2026-10-23T16:00:00Z"
}