Landline

This API enables third-party systems or apps to integrate Landline services into their systems via CellPay.

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",
    "description": "ok",
    "currencyId": "1",
    "webRequest": "true",
    "customValues": [
        {
            "internalName": "PAYMENTMETHOD",
            "fieldId": "15",
            "value": "Mobile Wallet"
        },
        {
            "internalName": "LANDLINENUMBER",
            "fieldId": "18",
            "value": "{{rechargeNumber}}"
        }
    ]
}

Book Payment – Successful Response (Sample)

{
    "status": true,
    "sessionExpired": false,
    "payload": {
        "DoPaymentResult": {
            "wouldRequireAuthorization": false,
            "from": {
                "id": "{{fromMemberId}}",
                "name": "{{fromMemberName}}",
                "username": "{{fromMemberUsername}}",
                "mobileNo": "{{fromMemberPrincipal}}" // User's cellpay registered mobile no is referred as principal
            },
            "finalAmount": 1.00,
            "formattedFinalAmount": "Rs. 1.00",
            "transferType": {
                "id": 85,
                "name": "Wallet NT Landline Bill Payment",
                "from": {
                    "id": 14,
                    "name": "Mobile Wallet",
                    "currency": {
                        "id": 1,
                        "symbol": "रु",
                        "name": "Nepalese Rupee"
                    }
                },
                "to": {
                    "id": 6,
                    "name": "Cellcom Float Account",
                    "currency": {
                        "id": 1,
                        "symbol": "रु",
                        "name": "Nepalese Rupee"
                    }
                }
            },
            "customValues": [
                {
                    "internalName": "PAYMENTMETHOD",
                    "fieldId": 15,
                    "value": "Mobile Wallet"
                },
                {
                    "internalName": "LANDLINENUMBER",
                    "fieldId": 18,
                    "value": "{{rechargeNumber}}"
                }
            ],
            "isOtpEnable": false,
            "showConsolidateAmount": false,
            "bookingId": 3
        }
    }
}

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": "1",
    "description": "ok",
    "traceNumber": "CEL-12345" //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique.
    "currencyId": "1",
    "webRequest": true,
    "bookingId": 3,
    "transactionPin": "XXXXXX",
    "customValues": [
        {
            "internalName": "PAYMENTMETHOD",
            "fieldId": "15",
            "value": "Mobile Wallet"
        },
        {
            "internalName": "LANDLINENUMBER",
            "fieldId": "18",
            "value": "{{rechargeNumber}}"
        }
    ]
}

Confirm Payment – Successful Response (Sample)

{
    "status": true,
    "sessionExpired": false,
    "payload": {
        "ConfirmPaymentResult": {
            "id": 100011,
    "traceNumber": "CEL-12345", //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique.
            "pending": false
        }
    }
}

Service Parameters

Parameter Name	Type	Required	Description
transferTypeId	Integer	Yes	Unique identifier for the Landline Bill Payment service.
amount	Decimal	Yes	Bill amount to be paid for the landline service.
description	String	No	Optional remarks or description for the transaction.
currencyId	Integer	Yes	Currency identifier. Use 1 for Nepalese Rupee (NPR).
webRequest	Boolean	Yes	Indicates whether the request is initiated from a web-based system.
customValues	Array	Yes	List of additional parameters required to process the landline bill payment.
customValues.fieldId	Integer	Yes	System-defined field identifier.
customValues.internalName	String	Yes	Internal parameter name. Supported values: PAYMENTMETHOD, LANDLINENUMBER.
customValues.value	String	Yes	Value corresponding to the internal parameter (e.g., wallet type, landline number).
bookingId	Integer	Yes	Booking reference returned from the Book Payment API. Required for Confirm Payment.
transactionPin	String	Yes	User’s transaction PIN. Required during Confirm Payment.
traceNumber	String	Yes	Unique transaction reference number used during Confirm Payment. Must be unique per transaction.
isOtpEnable	Boolean	No	Indicates whether OTP verification is required for the transaction.
otp	String	Yes	One-time password. Required only if OTP is enabled.