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.truq.it/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"
        }
    ] 
}

Response

{
    "status": "SUCCESS",
    "message": "Successully created business tripset",
    "data": {
        "id": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
        "user": "422cd8e2-4a18-42c2-97c8-xxxxxxxxxxxx",
        "organisation": "BOR_XXXX",
        "created_at": "2023-09-06T22:13:52.902696Z",
        "created_by": "2c1f67de-f21c-47c1-a755-xxxxxxxxxxxx",
        "reference": "BORA86N05112023011452",
        "business": {
            "id": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
            "reference": "BORA86N05112023011452",
        },
        "quote": {
            "base_fare": 200.0,
            "cost_per_kilometer": 4269.9,
            "vat_value": 11.625,
            "platform_fee": 75.0,
            "helper_charge": 0.0,
            "charge": 4556.525,
            "total_charge": 4556.525,
            "currency": "NGN",
            "reference": "TRIP-PYT-BORA86N05102023083452",
            "estimated_value": 0.0
        },
        "trips": [
            {
                "source": {
                    "address": "Ikoyi",
                    "latitude": 6.45,
                    "longitude": 3.4333,
                    "state": "Lagos"
                },
                "destination": {
                    "address": "Ojuelegba",
                    "latitude": 6.5111,
                    "longitude": 3.3666,
                    "state": "Lagos",
                    "stops": {
                        "number": 0,
                        "stopovers": []
                    }
                },
                "category_size": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
                "trip_type": "DISTRIBUTION-PER-CITY",
                "system_trip_type": "DISTRIBUTION-PER-CITY",
                "is_transit": false,
                "is_completed": false,
                "distance": 14.233,
                "added_on": "2023-05-10T08:34:51.655502Z",
                "status": "INITIATED",
                "system_status": "INITIATED",
                "is_insured": false,
                "is_paid": false,
                "vehicle_payment": {
                    "vehicle_payment": 3863.16,
                    "currency": "NGN",
                    "is_paid": false
                },
                "scheduled_date": "2023-03-22T10:00:06.755446Z",
                "confirmation": {},
                "user_journey": [
                    {
                        "status": "INITIATED",
                        "system_status": "INITIATED",
                        "message": "Trip Initiated",
                        "time": "2023-05-10 08:34:52.857545+00:00",
                        "longitude": 6.5111,
                        "latitude": 3.4333
                    }
                ]
            }        
        ]
    }
}