AOP Services

BusTempBooking

Post https://travel.bospay.co.in/api/V1/Bus/Travel/BusTempBooking

The BusTempBooking API is used to temporarily reserve selected seats for a bus journey before the final payment and confirmation step. This step ensures that the selected seats are blocked for a short duration to avoid double booking.

Note: request_id should be different for every

Body Parameters

{
    "boarding_Id": "24514",
    "corporatePaymentMode": 0,
    "corporateStatus": "0",
    "costCenterId": 0,
    "customer_Mobile": "98XXXXXXX0",
    "deal_Key": "",
    "dropping_Id": "156524",
    "gst": false,
    "gstin": "",
    "gstinHolderAddress": "",
    "gstinHolderName": "",
    "paX_Details": [
      {
        "age": 28,
        "dob": "05/06/1999",
        "fare": [],
        "gender": 0,
        "id_Number": "545XXXXX7852",
        "id_Type": 4,
        "ladies_Seat": false,
        "paX_Id": "1",
        "paX_Name": "Testing Master",
        "penalty_Charge": "0",
        "primary": true,
        "seat_Number": "11",
        "status": "",
        "ticket_Number": "",
        "title": "Mr"
      }
    ],
    "passenger_Email": "demo@example.com",
    "passenger_Mobile": "91XXXXXXXXX0",
    "projectId": 0,
    "remarks": "Bus BLR - MAA - 20/06/2025",
    "search_Key": "XXXXX20250412001",
    "bus_Key": "XXX788412XYZ",
    "seatMap_Key": "XXXX5765X",
    "sendEmail": true,
    "sendSMS": true,
    "iP_Address": "27.XXX.XX.76",
    "request_Id": "REQ123456",
    "imeI_Number": "353535353535353",
    "registrationID": "AOP-554"
}

Request Parameters

Name	Type	Description
boarding_Id	String	This requires the Boarding point id selected by the user.
corporatePaymentMode	Int	This requires the Payment Mode of the Bus.
corporateStatus	String	This requires the Corporate Status of the Bus.

Table

Name	Type	Description
boarding_Id	String	This requires the Boarding point id selected by the user.
corporatePaymentMode	Int	This requires the Payment Mode of the Bus.
corporateStatus	String	This requires the Corporate Status of the Bus.
costCenterId	Int	This requires the Cost Center Id of the Bus.
customer_Mobile	String	This requires the customer's mobile number.
deal_Key	String	This requires the Short Key of the Bus.
dropping_Id	String	This requires the Dropping point id selected by the user.
gst	Boolean	Set to true if applicable; otherwise false.
gstin	String	GST number of the passenger or business.
gstinHolderAddress	String	GST holder’s address.
gstinHolderName	String	GST holder’s name.
age	Int	Passanger's age.
dob	String	Passanger's date of birth (MM/DD/YYYY).
fare	List(String)	This requires the Fare.
gender	Int	Gender value: 0 = Male, 1 = Female.
id_Number	String	This field requires the ID number corresponding to the selected ID type.
id_Type	Int	ID Type: 0 = NONE, 1 = PAN_CARD, 2 = PASSPORT, 3 = VOTER_ID, 4 = AADHAAR_CARD.
ladies_Seat	Boolean	Set to true if applicable; otherwise false.
paX_Id	String	This requires the pax id (1 based starting index).
paX_Name	String	Passanger's name.
penalty_Charge	String	This requires the applicable penalty charge.
primary	Boolean	Set to true if applicable; otherwise false.
seat_Number	String	This requires the Seat Number.
status	String	This requires the Status.
ticket_Number	String	This requires the Ticket Number.
title	String	Passenger title (e.g., Mr, Mrs, Ms).
passenger_Email	String	This requires the passenger's email address.
passenger_Mobile	String	This requires the passenger's mobile number.
projectId	Int	This requires the Project Id of the Bus.
remarks	String	Remarks.
search_Key	String	This key contains the search details.
bus_Key	String	This key contains the bus details.
seatMap_Key	String	This requires the SeatMap key received from the response of the 'BusSeatMap' API.
sendEmail	Boolean	Set to false to disable Email notifications.
sendSMS	Boolean	Set to false to disable Sms notifications.
iP_Address	String	Belongs to the same server from which the API calls are made and where you will be consuming the API.
request_Id	String	Can be used as a unique identifier assigned to each user's individual request.
imeI_Number	String	The IMEI number of the user's device from which the request was made.
registrationID	String	Unique registration identifier, often tied to the user.

Responses

200

Response

200

RESPONSE BODY

Json

401

Response

401

RESPONSE BODY

Object

responsecode integer

status boolean

message string

Did this page help you? Yes No

Language

Shell

Python

Node

PHP

cURL

curl --location --request POST 'https://travel.bospay.co.in/api/V1/Bus/Travel/BusTempBooking' \
--header 'Content-Type: application/json' \
--data  '{
  "boarding_Id": "24514",
  "corporatePaymentMode": 0,
  "corporateStatus": "0",
  "costCenterId": 0,
  "customer_Mobile": "98XXXXXXX0",
  "deal_Key": "",
  "dropping_Id": "156524",
  "gst": false,
  "gstin": "",
  "gstinHolderAddress": "",
  "gstinHolderName": "",
  "paX_Details": [
    { 
      "age": 28,
      "dob": "05/06/1999",
      "fare": [],
      "gender": 0,
      "id_Number": "545XXXXX7852",
      "id_Type": 4,
      "ladies_Seat": false,
      "paX_Id": "1",
      "paX_Name": "Testing Master",
      "penalty_Charge": "0",
      "primary": true,
      "seat_Number": "11",
      "status": "",
      "ticket_Number": "",
      "title" "Mr"
    }
 ],
"passenger_Email": "demo@example.com",
"passenger_Mobile": "91XXXXXXXXX0",
"projectId": 0,
"remarks": "Bus BLR - MAA - 20/06/2025",
"search_Key": "XXXXX20250412001",
"bus_Key": "XXX788412XYZ",
"seatMap_Key": "XXXX5765X",
"sendEmail": true,
"sendSMS": true,
"iP_Address": "27.XXX.XX.76",
"request_Id": "REQ123456",
"imeI_Number": "353535353535353",
"registrationID": "AOP-554"
}'

import requests
import json

url = 'https://travel.bospay.co.in/api/V1/Bus/Travel/BusTempBooking'
payload = "{
  "boarding_Id": "24514",
  "corporatePaymentMode": 0,
  "corporateStatus": "0",
  "costCenterId": 0,
  "customer_Mobile": "98XXXXXXX0",
  "deal_Key": "",
  "dropping_Id": "156524",
  "gst": false,
  "gstin": "",
  "gstinHolderAddress": "",
  "gstinHolderName": "",
  "paX_Details": [
    { 
      "age": 28,
      "dob": "05/06/1999",
      "fare": [],
      "gender": 0,
      "id_Number": "545XXXXX7852",
      "id_Type": 4,
      "ladies_Seat": false,
      "paX_Id": "1",
      "paX_Name": "Testing Master",
      "penalty_Charge": "0",
      "primary": true,
      "seat_Number": "11",
      "status": "",
      "ticket_Number": "",
      "title" "Mr"
    }
 ],
"passenger_Email": "demo@example.com",
"passenger_Mobile": "91XXXXXXXXX0",
"projectId": 0,
"remarks": "Bus BLR - MAA - 20/06/2025",
"search_Key": "XXXXX20250412001",
"bus_Key": "XXX788412XYZ",
"seatMap_Key": "XXXX5765X",
"sendEmail": true,
"sendSMS": true,
"iP_Address": "27.XXX.XX.76",
"request_Id": "REQ123456",
"imeI_Number": "353535353535353",
"registrationID": "AOP-554"
}" 

headers = {
  "Content-type" : "application/json"
}

response = requests.request("POST", url, headers=headers, data=payload)

print (response.text)

var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://travel.bospay.co.in/api/V1/Bus/Travel/BusTempBooking',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: '{
   "boarding_Id": "24514",
  "corporatePaymentMode": 0,
  "corporateStatus": "0",
  "costCenterId": 0,
  "customer_Mobile": "98XXXXXXX0",
  "deal_Key": "",
  "dropping_Id": "156524",
  "gst": false,
  "gstin": "",
  "gstinHolderAddress": "",
  "gstinHolderName": "",
  "paX_Details": [
    { 
      "age": 28,
      "dob": "05/06/1999",
      "fare": [],
      "gender": 0,
      "id_Number": "545XXXXX7852",
      "id_Type": 4,
      "ladies_Seat": false,
      "paX_Id": "1",
      "paX_Name": "Testing Master",
      "penalty_Charge": "0",
      "primary": true,
      "seat_Number": "11",
      "status": "",
      "ticket_Number": "",
      "title" "Mr"
    }
 ],
"passenger_Email": "demo@example.com",
"passenger_Mobile": "91XXXXXXXXX0",
"projectId": 0,
"remarks": "Bus BLR - MAA - 20/06/2025",
"search_Key": "XXXXX20250412001",
"bus_Key": "XXX788412XYZ",
"seatMap_Key": "XXXX5765X",
"sendEmail": true,
"sendSMS": true,
"iP_Address": "27.XXX.XX.76",
"request_Id": "REQ123456",
"imeI_Number": "353535353535353",
"registrationID": "AOP-554"
  }' 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
});

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get,'https://travel.bospay.co.in/api/V1/Bus/Travel/BusTempBooking
  "{
  "boarding_Id": "24514",
  "corporatePaymentMode": 0,
  "corporateStatus": "0",
  "costCenterId": 0,
  "customer_Mobile": "98XXXXXXX0",
  "deal_Key": "",
  "dropping_Id": "156524",
  "gst": false,
  "gstin": "",
  "gstinHolderAddress": "",
  "gstinHolderName": "",
  "paX_Details": [
    { 
      "age": 28,
      "dob": "05/06/1999",
      "fare": [],
      "gender": 0,
      "id_Number": "545XXXXX7852",
      "id_Type": 4,
      "ladies_Seat": false,
      "paX_Id": "1",
      "paX_Name": "Testing Master",
      "penalty_Charge": "0",
      "primary": true,
      "seat_Number": "11",
      "status": "",
      "ticket_Number": "",
      "title" "Mr"
    }
 ],
"passenger_Email": "demo@example.com",
"passenger_Mobile": "91XXXXXXXXX0",
"projectId": 0,
"remarks": "Bus BLR - MAA - 20/06/2025",
"search_Key": "XXXXX20250412001",
"bus_Key": "XXX788412XYZ",
"seatMap_Key": "XXXX5765X",
"sendEmail": true,
"sendSMS": true,
"iP_Address": "27.XXX.XX.76",
"request_Id": "REQ123456",
"imeI_Number": "353535353535353",
"registrationID": "AOP-554"
  }",
  null,"application/json"
); 

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://travel.bospay.co.in/api/V1/Bus/Travel/BusTempBooking',
  CURLOPT_RETURNTRANSFER =>  true,
  CURLOPT_ENCODING =>  '',
  CURLOPT_MAXREDIRS =>  10,
  CURLOPT_TIMEOUT =>  0,
  CURLOPT_FOLLOWLOCATION =>  true,
  CURLOPT_HTTP_VERSION =>  CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =>  'POST',
  CURLOPT_POSTFIELDS =>  '{
  "boarding_Id": "24514",
  "corporatePaymentMode": 0,
  "corporateStatus": "0",
  "costCenterId": 0,
  "customer_Mobile": "98XXXXXXX0",
  "deal_Key": "",
  "dropping_Id": "156524",
  "gst": false,
  "gstin": "",
  "gstinHolderAddress": "",
  "gstinHolderName": "",
  "paX_Details": [
    { 
      "age": 28,
      "dob": "05/06/1999",
      "fare": [],
      "gender": 0,
      "id_Number": "545XXXXX7852",
      "id_Type": 4,
      "ladies_Seat": false,
      "paX_Id": "1",
      "paX_Name": "Testing Master",
      "penalty_Charge": "0",
      "primary": true,
      "seat_Number": "11",
      "status": "",
      "ticket_Number": "",
      "title" "Mr"
    }
 ],
"passenger_Email": "demo@example.com",
"passenger_Mobile": "91XXXXXXXXX0",
"projectId": 0,
"remarks": "Bus BLR - MAA - 20/06/2025",
"search_Key": "XXXXX20250412001",
"bus_Key": "XXX788412XYZ",
"seatMap_Key": "XXXX5765X",
"sendEmail": true,
"sendSMS": true,
"iP_Address": "27.XXX.XX.76",
"request_Id": "REQ123456",
"imeI_Number": "353535353535353",
"registrationID": "AOP-554"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE

{
"booking_RefNo": "BBB6YLRP",
"response_Header": {
    "error_Code": "0000",
    "error_Desc": "SUCCESS",
    "error_InnerException": "",
    "request_Id": "REQ123456",
    "status_Id": "11"
}, 
"updatedFares": [],
"statuss": "True",
"message": "Transaction successfully",
"value": ""
 }

{
    "code": "207",
    "description": "Amount is Requaired",
    "merchantTrxnRefId": null,
    "token": null,
    "status": "False"
}