Skip to content

Overview

The Delivery API lets your business send parcels with Tujyane. Your backend asks for a price, books the delivery, and follows it to the door. A Tujyane Delivery Partner on a motorcycle or in a car collects the parcel at your pickup point and brings it to your customer.

  1. Your customer orders from you. Your server quotes the delivery to get Tujyane’s price.
  2. Your server creates a Shipment. Tujyane stores it with its fee and contacts no partner yet.
  3. When your customer has paid you, your server confirms the Shipment. Tujyane offers it to the nearest available Delivery Partner, one partner at a time.
  4. A partner accepts, collects the parcel, and delivers it. Tujyane sends each step to your webhook. You can also follow the partner’s position on a live event stream.
  5. Each month, Tujyane sends you a statement for the delivered and returned Shipments, and you pay it.
Term Meaning
Delivery Client Your business, as a Tujyane customer of the Delivery API.
Shipment One parcel delivery, from one pickup point to one Recipient.
Recipient Your customer, who receives the parcel.
Delivery Partner The Tujyane rider or driver who carries the parcel.
Delivery Code A 4-digit code your customer gives the partner at the door. It proves the parcel reached the right person.
Mode TEST or LIVE. The prefix of your API key sets it.
  • An API key for each mode. Tujyane issues them. See Authentication.
  • An https URL on your server that receives webhooks, and the webhook secret that Tujyane gives you with it. See Webhooks.
  • A way to give your customer their Delivery Code, if your account uses codes. See Delivery Codes.

All routes are under one base URL, in both modes:

https://api.tujyaneltd.com/api/v1/delivery-api

Tujyane sends your customer no SMS and no email. Send them updates yourself, from the webhooks.

If your customer uses the Tujyane app, and the app account’s verified phone is the Recipient phone, the app also shows the LIVE Shipment. It shows the pickup name, the partner’s name, phone and plate, the partner’s live position and the Delivery Code. It never shows the price or your reference. The app sends a push notification when a partner is assigned, picks up the parcel, is arriving, delivers it, or cannot deliver it.