Booking a merchant trip

Booking a business trip is a feature available on the business dashboard, and via Open API that allows your onboarded businesses to create a tripset and manage the status updates of all trips added to the tripset, while you manage the trips information processes from initiation to reconciliation.

So when your businesses create a tripset, a single trip or multiple trips are booked as a part of a tripset. They can view the trip on their dashboard and with open API, while you manage the trip process on your dashboard.

Collect trip information

The business, trip_type , category_size, scheduled_date, source, destination, parameters are required to book a business tripset. They are not optional.

Endpoint
https://dodge-apis-c2btvqbhlq-uc.a.run.app/entity-service/business/business-tripset/
-H "Authorization: Bearer YOUR_SECRET_KEY"
-H "Organisation: YOUR_REFERENCE"
-X POST
Request Body
{ 
    "business": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
    "trips": [
        {
            "source": { 
                "address": "Ikoyi", 
                "latitude": 6.4500, 
                "longitude": 3.4333, 
                "state": "Lagos" 
            },
            "destination": { 
                "address": "Ikoyi", 
                "latitude": 6.4500, 
                "longitude": 3.4333, 
                "state": "Lagos",
                "stops": {
                    "number": 0,
                    "stopovers": []
                }
            },
            "trip_type": "DISTRIBUTION_PER_CITY",
            "category_size": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
            "scheduled_date": "2023-03-22T10:00:00.755446+00:00"
        }
    ] 
}

Last updated