Skip to main content

Quick Start Guide

This guide helps Logistics Partners integrate the NowPost White-Label Network.

Prerequisites​

  1. Partner Agreement signed with NowPost.
  2. API Credentials (Client ID & Secret).
  3. Whitelisted IPs for server access.

Step 1: Authentication​

Get an access token to start making requests.

POST /api/v1/auth/token
{
  "client_id": "...",
  "client_secret": "..."
}

For performance, you may want to cache our PUDO points database locally instead of fetching real-time for every user search.

  • Call GET /api/v1/partners/pudo-points?limit=1000
  • Store id, lat, lng, address, city in your DB.
  • Set up a daily cron job to sync updates.

Step 3: Implement "Find Location"​

Add a "Ship to Pickup Point" option in your booking flow. Use the data from Step 2 to show points on your map.

Crucial: Do not display the name "NowPost" to your customers. Call it "Pickup Point" or "YourBrand Point".

Step 4: Create Delivery Order​

When a user books a shipment to a point:

POST /api/v1/partners/orders
{
  "pudo_point_id": "pudo_123",
  "recipient": {
    "name": "Customer Name",
    "phone": "+234..."
  },
  "reference": "YOUR_TRACKING_NUM"
}

Response will contain a collection_code. Do not share this with the customer yet.

Step 5: Deliver to Point​

Route your driver to the PUDO point address.

Step 6: Driver Drop-off​

When your driver arrives at the point:

  1. Driver hands package to PUDO Agent.
  2. Agent scans package.
  3. System Event: We trigger a webhook package.arrived_at_point.

Step 7: Notify Customer​

Upon receiving the package.arrived_at_point webhook:

  1. You retrieve the collection_code from your DB (or the webhook payload).
  2. YOU send the SMS/Email to the customer:

    "Your package is ready at [Address]. Code: 123456."

This ensures the communication comes from YOUR brand.