Nepal Telecom (NT) Datapack/Voicepack
This API enables third-party systems or apps to integrate NT Datapack/Voicepack services into their systems via CellPay.
Response Structure for Nepal Telecom (NT) Datapack and Voicepack APIs
The Nepal Telecom (NT) Datapack and Voicepack APIs return the same request structure. The only difference between the two requests is the content of the extraParam field.
For Datapack requests, extraParam contains data-specific details, while for Voicepack requests, extraParam contains voice-related details. All other response fields remain identical for both APIs.
Get Pack Details
Endpoint:
{base-url}/product-types/ntc
Method: GET
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Get Pack Details – Response Example
{
"status": true,
"sessionExpired": false,
"payload": {
"possibleValues": [
{
"name": "Data Pack",
"code": "DATA"
},
{
"name": "Voice Pack",
"code": "VOICE"
},
{
"name": "Combo Pack",
"code": "COMBO"
},
{
"name": "SMS Pack",
"code": "SMS"
}
]
}
}
Get Possible Values
Endpoint:
{base-url}/payments/possibleValues/{transferTypeId}
Method: POST
Request Headers:
The following HTTP headers are required when calling the API:
Content-Type: application/json
Cellpay-Access-Token: {{accessToken}}
Get Possible Values – Request
{
"productType" : "DATA"
}
Get Possible Values – Response Example
{
"status": true,
"sessionExpired": false,
"payload": {
"possibleValues": [
{
"productName": "Unlimited data @1Mbps ",
"headline": "Unlimited data @1Mbps 1 Day",
"firstView": "Unlimited data @1Mbps 1 Day",
"detailView": "Unlimited Data @ 1 Mbps1 Day",
"productCost": "49.9800",
"productCode": "92",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Unlimited data Upto 5Mbps",
"headline": "Unlimited data Upto 5Mbps1 Day",
"firstView": "Unlimited data Upto 5Mbps1 Day",
"detailView": "Unlimited Data @ 5 Mbps1 Day",
"productCost": "90.7900",
"productCode": "93",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Data pack 4 GB",
"headline": "Data pack 4 GB1 Day",
"firstView": "Data pack 4 GB1 Day",
"detailView": "Valid for 1 Day1 Day",
"productCost": "100.9800",
"productCode": "80",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Data Pack 5 GB ",
"headline": "Data Pack 5 GB 7 Days",
"firstView": "Data Pack 5 GB 7 Days",
"detailView": "Valid for 7 Days7 Days",
"productCost": "111.1900",
"productCode": "82",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Data Pack 100 GB 28 Days",
"headline": "Data Pack 100 GB 28 Days30 days",
"firstView": "Data Pack 100 GB 28 Days30 days",
"detailView": "Valid for 30 days30 days",
"productCost": "1019.0800",
"productCode": "87",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "YouTube Pack Unlimited ",
"headline": "YouTube Pack Unlimited 3 Days",
"firstView": "YouTube Pack Unlimited 3 Days",
"detailView": "Valid for 3 Days 3 Days",
"productCost": "56.1000",
"productCode": "89",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Facebook Pack Unlimited ",
"headline": "Facebook Pack Unlimited 3 Days",
"firstView": "Facebook Pack Unlimited 3 Days",
"detailView": "Valid for 3 Days 3 Days",
"productCost": "56.1000",
"productCode": "90",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Unlimited 2 hours data from now Pack",
"headline": "Unlimited 2 hours data from now Pack2 hours",
"firstView": "Unlimited 2 hours data from now Pack2 hours",
"detailView": "Valid for 2 hours from subscription2 hours",
"productCost": "35.7000",
"productCode": "77",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "12 GB Data for ",
"headline": "12 GB Data for 7 Days",
"firstView": "12 GB Data for 7 Days",
"detailView": "Valid for all time7 Days",
"productCost": "203.0000",
"productCode": "78",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "1GB per day",
"headline": "1GB per day1 Day",
"firstView": "1GB per day1 Day",
"detailView": "Valid for all time1 Day",
"productCost": "30.6000",
"productCode": "79",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Prepaid Data Pack_20GB ",
"headline": "Prepaid Data Pack_20GB 30 days",
"firstView": "Prepaid Data Pack_20GB 30 days",
"detailView": "20Gb for 30 days30 days",
"productCost": "407.0200",
"productCode": "135",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Prepaid Data Pack_55GB ",
"headline": "Prepaid Data Pack_55GB 30 days",
"firstView": "Prepaid Data Pack_55GB 30 days",
"detailView": "30Gb for 30 days30 days",
"productCost": "917.0700",
"productCode": "137",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Prepaid Data Pack_40GB_30days",
"headline": "Prepaid Data Pack_40GB_30days30 days",
"firstView": "Prepaid Data Pack_40GB_30days30 days",
"detailView": "Data 40GB\n30 days",
"productCost": "560.0300",
"productCode": "152",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Prepaid Data Pack_2GB/Day_30days",
"headline": "Prepaid Data Pack_2GB/Day_30days30 days",
"firstView": "Prepaid Data Pack_2GB/Day_30days30 days",
"detailView": "2GB/Day\n30 days",
"productCost": "611.0400",
"productCode": "153",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "600MB per day",
"headline": "600MB per day1 Day",
"firstView": "600MB per day1 Day",
"detailView": "Valid for all time1 Day",
"productCost": "22.4400",
"productCode": "127",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": " Data Pack_11GB_30days",
"headline": " Data Pack_11GB_30days30 days",
"firstView": " Data Pack_11GB_30days30 days",
"detailView": "Data 11GB\n\n30 days",
"productCost": "335.6100",
"productCode": "151",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
},
{
"productName": "Data Pack_1GB/Day_30days",
"headline": "Data Pack_1GB/Day_30days30 days",
"firstView": "Data Pack_1GB/Day_30days30 days",
"detailView": "1GB/Day\n\n30 days",
"productCost": "356.0100",
"productCode": "154",
"productType": "Data Pack",
"productOperator": "NT",
"status": true
}
]
}
}
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": "1.0",
"description": "nt voice service package",
"currencyId": "1",
"webRequest": true,
"customValues": [
{
"fieldId": "16",
"internalName": "MOBILENUMBER",
"value": "{{rechargeNumber}}"
},
{
"fieldId": "15",
"internalName": "PAYMENTMETHOD",
"value": "Account"
},
{
"internalName": "SELECTBANK",
"fieldId": 35,
"value": " {{senderBankCode}} "
},
{
"internalName": "ACCOUNTNUMBER",
"fieldId": 14,
"value": " {{senderBankAccountNumber}} "
}
],
"extraParam": {
"productType": "VOICE",
"productCode": "67"
}
}
Book Payment – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"DoPaymentResult": {
"wouldRequireAuthorization": false,
"from": {
"id": "{memberId}",
"name": "{memberName}",
"username": "{memberUserName}",
"mobileNo": "{memberMobileNumber}",
"premiumMember": false
},
"finalAmount": 18.3600,
"formattedFinalAmount": "NPR 18.36",
"transferType": {
"id": 402,
"name": "Wallet NTC Pack",
"title": "NT Data Pack",
"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": "MOBILENUMBER",
"fieldId": 16,
"value": "{rechargeNumber}"
},
{
"internalName": "PAYMENTMETHOD",
"fieldId": 15,
"value": "Account"
},
{
"internalName": "SELECTBANK",
"fieldId": 35,
"value": " {{senderBankCode}} "
},
{
"internalName": "ACCOUNTNUMBER",
"fieldId": 14,
"value": " {{senderBankAccountNumber}} "
}
],
"isOtpEnable": false,
"showConsolidateAmount": false,
"extraParam": {
"productType": "VOICE",
"productCode": "67",
"eventId": 0,
"subEventId": 0,
"disableOtp": false,
"renewOption": false
}
}
}
}
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": "18.36",
"traceNumber": "CEL-123456", //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique.
"description": "nt voice service package",
"currencyId": "1",
"webRequest": true,
"bookingId": 12,
"transactionPin": "{{login-password}}",
"customValues": [
{
"fieldId": "16",
"internalName": "MOBILENUMBER",
"value": "{memberMobileNumber}"
},
{
"fieldId": "15",
"internalName": "PAYMENTMETHOD",
"value": "Account"
},
{
"internalName": "SELECTBANK",
"fieldId": 35,
"value": " {{senderBankCode}} "
},
{
"internalName": "ACCOUNTNUMBER",
"fieldId": 14,
"value": " {{senderBankAccountNumber}} "
}
],
"extraParam": {
"productType": "VOICE",
"productCode": "67"
}
}
Confirm Payment – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"ConfirmPaymentResult": {
"id": 169564,
"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.
}
}
}
Service Parameters
| Parameter Name | Type | Required | Description |
|---|---|---|---|
transferTypeId | Integer | Yes | Unique identifier for the Nepal Telecom (NT) Datapack or Voicepack service. |
amount | Decimal | Yes | Transaction amount corresponding to the selected NT Datapack or Voicepack. |
description | String | No | Description or remarks for the transaction (e.g., Data Pack, Voice Pack). |
currencyId | Integer | Yes | Currency identifier. Use 1 for Nepalese Rupee (NPR). |
webRequest | Boolean | Yes | Indicates whether the request originates from a web-based system. |
customValues | Array | Yes | List of additional parameters required for processing the transaction. |
customValues.fieldId | Integer | Yes | System-defined field identifier. |
customValues.internalName | String | Yes | Internal parameter name (e.g., MOBILENUMBER, PAYMENTMETHOD). |
customValues.value | String | Yes | Value corresponding to the internal parameter. |
isOtpEnable | Boolean | No | Indicates whether OTP validation is required. |
otp | String | Conditional | One-time password. Required only if OTP is enabled. |
bookingId | Integer | Conditional | Booking reference returned from the Book Payment API. Required for Confirm Payment. |
transactionPin | String | Conditional | User’s transaction PIN. Required during Confirm Payment. |
traceNumber | String | Conditional | Unique transaction reference number used during Confirm Payment. Must be unique per transaction. |
extraParam | Object | Conditional | Contains product-specific details. Returned in the Book Payment response and varies based on Datapack or Voicepack selection. |
extraParam.productType | String | Yes (Response) | Type of product. Possible values: DATA or VOICE. |
extraParam.productCode | String | Yes (Response) | Unique code identifying the selected NT Datapack or Voicepack product. |
extraParam.eventId | Integer | No | System-generated event identifier. |
extraParam.subEventId | Integer | No | System-generated sub-event identifier. |
extraParam.disableOtp | Boolean | No | Indicates whether OTP is disabled for this transaction (system-controlled). |