Domestic Flight Ticket
This API enables third-party systems or apps to integrate Domestic Flight services into their systems via CellPay.
Get Possible Values
Endpoint:
{base-url}/payments/possibleValues/{transferTypeId}
Method: GET
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Get Possible Values – Response Example
{
"status": true,
"sessionExpired": false,
"payload": {
"possibleValues": {
"sectors": [
{
"sectorCode": "BDP",
"sectorName": "BHADRAPUR"
},
{
"sectorCode": "BWA",
"sectorName": "BHAIRAHAWA"
},
{
"sectorCode": "BHR",
"sectorName": "BHARATPUR"
}
]
}
}
}
Retrieve Possible Flight Trips
Endpoint:
{base-url}/payments/possibleTrips/{transferTypeId}
Method: POST
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Retrieve Possible Flight Trips – Request Example
{
"fromSector": "KTM",
"toSector": "PKR",
"tripType": "O",
"departureDate": "2025-07-04",
"returnDate": "",
"nationality": "NP",
"adult": "1",
"child": "0"
}
Retrieve Possible Flight Trips – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"possibleTrips": {
"outBoundFlightList": [
{
"childDiscount": "0.00",
"departureTime": "08:00",
"arrival": "POKHARA",
"flightId": 9780,
"agencyChildCommission": "200.00",
"flightClassCode": "S",
"freeBaggage": "20 + 5 KG",
"agencyAdultFee": "0.00",
"arrivalTime": "08:30",
"currency": "NPR",
"refundable": "F",
"cellpayLoyalty": 160.00,
"airline": "Saurya Airlines",
"airlineLogo": "static/images/S1.png",
"adultFare": "1641.00",
"flightDate": "2025-07-04",
"childFare": "1641.00",
"tax": "0.00",
"adultDiscount": "0.00",
"agencyAdultCommission": "200.00",
"agencyChildFee": "0.00",
"totalAmount": 4381.00,
"flightNo": "S1103",
"departure": "KATHMANDU",
"adult": 1,
"fuelSurcharge": "2740.00",
"child": 0
},
{
"childDiscount": "0.00",
"departureTime": "08:00",
"arrival": "POKHARA",
"flightId": 9781,
"agencyChildCommission": "200.00",
"flightClassCode": "N",
"freeBaggage": "20 + 5 KG",
"agencyAdultFee": "0.00",
"arrivalTime": "08:30",
"currency": "NPR",
"refundable": "T",
"cellpayLoyalty": 160.00,
"airline": "Saurya Airlines",
"airlineLogo": "static/images/S1.png",
"adultFare": "4657.85",
"flightDate": "2025-07-04",
"childFare": "3112.18",
"tax": "0.00",
"adultDiscount": "0.00",
"agencyAdultCommission": "200.00",
"agencyChildFee": "0.00",
"totalAmount": 4657.85,
"flightNo": "S1103",
"departure": "KATHMANDU",
"adult": 1,
"fuelSurcharge": "0.00",
"child": 0
}
]
}
}
}
Reserve Ticket
Endpoint:
{base-url}/payments/bookingDetails/{transferTypeId}
Method: POST
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Reserve Ticket – Request Example
{
"tripType": "O",
"adult": "1",
"child": "0",
"nationality": "NP",
"departureId": "9780",
"returnId": ""
}
Reserve Ticket – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"bookingDetails": {
"bookingDetails": {
"totalAmount": "4381.00",
"tripType": "2",
"pnrNumber": "CXOQ1C",
"adult": "1",
"uuid": "2bf322e4-85b0-4ef9-a5e4-562ab9b999fe",
"child": "0"
}
}
}
}
Save Passenger Details
Endpoint:
{base-url}/payments/passengerDetail/{transferTypeId}
Method: POST
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Save Passenger Details – Request Example
{
"uuid": "2bf322e4-85b0-4ef9-a5e4-562ab9b999fe", //gather uuid from previous post request on Reserve Ticket
"contactName": "test user",
"contactEmail": "test.user@gmail.com",
"contactNumber": "9818283848",
"passenger": [
{
"paxType": "ADULT",
"title": "Mr",
"gender": "M",
"firstName": "test",
"lastName": "user",
"nationality": "NP"
}
]
}
Save Passenger Details – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"savePassengerDetails": "Passenger's Information Added"
}
}
Book Payment
Endpoint:
{base-url}/payments/systemPayment
Method: POST
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Book Payment – Request Example
{
"transferTypeId": "{{transferTypeId}}",
"amount": "4381.00",
"description": "ok",
"currencyId": "1",
"webRequest": true,
"customValues": [
{
"fieldId": "182",
"internalName": "UUID",
"value": "2bf322e4-85b0-4ef9-a5e4-562ab9b999fe"
},
{
"fieldId": "183",
"internalName": "RETURN_ID",
"value": ""
},
{
"fieldId": "184",
"internalName": "PASSENGER_INFO",
"value": "test user"
},
{
"fieldId": "174",
"internalName": "NAME",
"value": "test user"
},
{
"fieldId": "16",
"internalName": "MOBILENUMBER",
"value": "9818283848"
},
{
"fieldId": "190",
"internalName": "EMAIL_ADDRESS",
"value": "test.user@gmail.com"
},
{
"fieldId": "15",
"internalName": "PAYMENTMETHOD",
"value": "Account"
},
{
"fieldId": "35",
"internalName": "SELECTBANK",
"value": "{{senderBankCode}}"
},
{
"fieldId": "14",
"internalName": "ACCOUNTNUMBER",
"value": "{{senderBankAccountNumber}}"
}
]
}
Book Payment – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"DoPaymentResult": {
"wouldRequireAuthorization": false,
"from": {
"id": {{fromMemberId}},
"name": "{{fromMemberName}}",
"username": "{{fromMemberUsername}}",
"mobileNo": "{{fromMemberPrincipal}}",
"premiumMember": false
},
"finalAmount": 4381.00,
"formattedFinalAmount": "Rs. 4,381.00",
"transferType": {
"id": {{transferTypeId}},
"name": "{{transferTypeName}}",
"from": {
"id": 5,
"name": "Account",
"currency": {
"id": 1,
"symbol": "रु",
"name": "Nepalese Rupee"
}
},
"to": {
"id": 6,
"name": "Cellcom Float Account",
"currency": {
"id": 1,
"symbol": "रु",
"name": "Nepalese Rupee"
}
}
},
"customValues": [
{
"internalName": "UUID",
"fieldId": 182,
"value": "2bf322e4-85b0-4ef9-a5e4-562ab9b999fe"
},
{
"internalName": "RETURN_ID",
"fieldId": 183
},
{
"internalName": "PASSENGER_INFO",
"fieldId": 184,
"value": "test user"
},
{
"internalName": "NAME",
"fieldId": 174,
"value": "test user"
},
{
"internalName": "MOBILENUMBER",
"fieldId": 16,
"value": "9818283848"
},
{
"internalName": "EMAIL_ADDRESS",
"fieldId": 190,
"value": "test.user@gmail.com"
},
{
"internalName": "PAYMENTMETHOD",
"fieldId": 15,
"value": "Account"
},
{
"fieldId": "35",
"internalName": "SELECTBANK",
"value": "{{senderBankCode}}"
},
{
"fieldId": "14",
"internalName": "ACCOUNTNUMBER",
"value": "{{senderBankAccountNumber}}"
}
],
"isOtpEnable": false,
"showConsolidateAmount": false,
"bookingId": 123
}
}
}
Confirm Payment
Endpoint:
{base-url}/payments/confirmSystemPayment
Method: POST
Request Headers:
The following headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Confirm Payment – Request Example
{
"transferTypeId": "{{transferTypeId}}",
"amount": "4381.00",
"traceNumber": "CEL-123456", //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique.
"description": "ok",
"currencyId": "1",
"webRequest": true,
"bookingId": 123,
"transactionPin": "XXXXXX",
"customValues": [
{
"fieldId": "182",
"internalName": "UUID",
"value": "2bf322e4-85b0-4ef9-a5e4-562ab9b999fe"
},
{
"fieldId": "183",
"internalName": "RETURN_ID",
"value": ""
},
{
"fieldId": "184",
"internalName": "PASSENGER_INFO",
"value": "test user"
},
{
"fieldId": "174",
"internalName": "NAME",
"value": "test user"
},
{
"fieldId": "16",
"internalName": "MOBILENUMBER",
"value": "9818283848"
},
{
"fieldId": "190",
"internalName": "EMAIL_ADDRESS",
"value": "test.user@gmail.com"
},
{
"fieldId": "15",
"internalName": "PAYMENTMETHOD",
"value": "Account"
},
{
"fieldId": "35",
"internalName": "SELECTBANK",
"value": "{{senderBankCode}}"
},
{
"fieldId": "14",
"internalName": "ACCOUNTNUMBER",
"value": "{{senderBankAccountNumber}}"
}
]
}
Confirm Payment – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"ConfirmPaymentResult": {
"id": 171501,
"pending": false,
"traceNumber": "CEL-123456", //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique.
"responseObject": {
"departurePnrNo": "CXOQ1C",
"departureDate": "2025-07-04 08:00:00",
"tripType": "O",
"sector": "KTM-PKR"
}
}
}
}
Service Parameters
| Parameter Name | Parameter Type | Required? | Description |
|---|---|---|---|
fromSector | String | Yes | Departure location (origin airport or city code). |
toSector | String | Yes | Arrival location (destination airport or city code). |
tripType | String | Yes | Trip type: O for one-way, R for round-trip. |
departureDate | String | Yes | Date of departure (format: YYYY-MM-DD). |
returnDate | String | Conditional | Return date (required only for round-trip). |
nationality | String | Yes | Passenger nationality. Supported values: NP (Nepalese), IN (Indian). |
adult | Integer | Yes | Number of adult passengers. |
child | Integer | Yes | Number of child passengers. |
departureId | Integer | Yes | Flight ID for the selected departure flight. |
uuid | String | Yes | Unique identifier for each flight. |
contactName | String | Yes | Name of the contact person. |
contactEmail | String | Yes | Email address of the contact person. |
contactNumber | String | Yes | Phone number of the contact person. |
paxType | String | Yes | Passenger type. Possible values: ADULT, CHILD. |
title | String | Yes | Passenger title (e.g., Mr, Mrs, Ms). |
gender | String | Yes | Passenger gender (e.g., Male, Female). |