Booking a standard trip
Booking a standard trip is a feature available on the customer dashboard, and via Open API that allows your customers to create a trip, while you manage the trip information processes from initiation to reconciliation.
So when your customers book a trip, they can view the trip on their dashboard, while you manage the trip process on your dashboard.
Collect trip information
The trip_type
, category_size
, scheduled_date
, source
, destination
, and parameters are required to book a customer trip. They are not optional. The email
, first_name
, last_name
, and phone
fields allow us to validate the user.
The callback_url
field is an optional field which redirects back to your application after a successful payment checkout.
https://dodge.truq.it/booking-service/booking/booking-trip/create_open_trip/
-H "Authorization: Bearer YOUR_PUBLIC_KEY"
-H "Organisation: YOUR_REFERENCE"
-X POST
{
"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": []
}
},
"email": "john@doe.com",
"first_name": "John",
"last_name": "Doe",
"phone": "2348000000000",
"trip_type": "INTRASTATE",
"category_size": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
"callback_url": "https://beta.mytruq.com/tracking-page",
"scheduled_date": "2023-03-22T10:00:00.755446+00:00"
}
{
"status": "SUCCESS",
"message": "Successfully calculated trip quote information",
"data": {
"id": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
"reference": "BORA86N05112023011452",
"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": []
}
},
"organisation": "BOR_A86N",
"is_interoperability": false,
"category_size": "422cd8e2-4a19-42c2-97c8-xxxxxxxxxxxx",
"trip_type": "INTRASTATE",
"system_trip_type": "INTRASTATE",
"extras": {
"packaging_boxes": 0
},
"is_transit": false,
"is_completed": false,
"distance": 14.233,
"helper_info": {},
"added_on": "2023-05-10T08:34:51.655502Z",
"status": "INITIATED",
"system_status": "INITIATED",
"is_insured": false,
"is_paid": false,
"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,
"checkout_url": "https://checkout.paystack.com/xxxxxxxxxx"
},
"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
}
]
}
}
Last updated