Electricity

This API enables third-party systems or apps to integrate Electricity 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": {
            "branches": [
                {
                    "branchCode": "243",
                    "branchName": "AANBU DC"
                },
                {
                    "branchCode": "391",
                    "branchName": "ACHHAM DC"
                },
                {
                    "branchCode": "273",
                    "branchName": "AMUWA DC"
                },
                {
                    "branchCode": "268",
                    "branchName": "ANARMANI DC"
                },
                {
                    "branchCode": "248",
                    "branchName": "ARGHAKHACHI DC"
                },
                {
                    "branchCode": "372",
                    "branchName": "VURIGAUN DC"
                }
            ]
        }
    }
}

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": "transfer",
    "currencyId": "1",
    "webRequest": true,
    "customValues": [
        {
            "internalName": "COUNTER",
            "fieldId": "22",
            "value": "296"
        },
        {
            "internalName": "SC_NUMBER",
            "fieldId": "23",
            "value": "018.12.029"
        },
        {
            "internalName": "CUSTOMERID",
            "fieldId": "21",
            "value": "15919"
        },
        {
            "internalName": "PAYMENTMETHOD",
            "fieldId": "15",
            "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": 292,
            "formattedFinalAmount": "NPR 292.00",
            "transferType": {
                "id": {{transferTypeId}},
                "name": "{{transferTypeName}}",
                "title": "{{transferTypeTitle}}",
                "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": "COUNTER",
                    "fieldId": 22,
                    "value": "338"
                },
                {
                    "internalName": "SC_NUMBER",
                    "fieldId": 23,
                    "value": "004.24.002"
                },
                {
                    "internalName": "CUSTOMERID",
                    "fieldId": 21,
                    "value": "{{customerId}}"
                },
                {
                    "internalName": "PAYMENTMETHOD",
                    "fieldId": 15,
                    "value": "Account"
                },
                {
                    "fieldId": "35",
                    "internalName": "SELECTBANK",
                    "value": "{{senderBankCode}}"
                },
                {
                    "fieldId": "14",
                    "internalName": "ACCOUNTNUMBER",
                    "value": "{{senderBankAccountNumber}}"
                }
            ],
            "isOtpEnable": false,
            "advanceValues": {
                "payments": {
                    "payments": [
                        {
                            "billAmount": "292",
                            "amount": "292",
                            "destination": "Mangsir/2082",
                            "description": "NoOfDays:12",
                            "billDate": "10-DEC-25",
                            "status": "Normal"
                        },
                        {
                            "billAmount": "-0.7",
                            "amount": "0",
                            "destination": "ADVANCE",
                            "description": "NoOfDays:0",
                            "billDate": "21-DEC-25",
                            "status": "Normal"
                        }
                    ]
                },
                "customerDetails": "{{customerDetails}}"
            },
            "showConsolidateAmount": 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": "1",
    "description": "transfer",
    "currencyId": "1",
    "webRequest": true,
    "bookingId": 8,
    "transactionPin": "xxxxxx",
    "traceNumber": "CEL-123456", //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique. 
    "customValues": [
        {
            "internalName": "COUNTER",
            "fieldId": "22",
            "value": "296"
        },
        {
            "internalName": "SC_NUMBER",
            "fieldId": "23",
            "value": "018.12.029"
        },
        {
            "internalName": "CUSTOMERID",
            "fieldId": "21",
            "value": "{{customerId}}"
        },
        {
            "internalName": "PAYMENTMETHOD",
            "fieldId": "15",
            "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": 101010,
            "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	Parameter Type	Required?	Description
COUNTER	String	Yes	Counter value fetched from the Possible Values API. Distribution Center (DC) may vary by district.
SC_NUMBER	String	Yes	Service Connection (SC) number provided by NEA.
CUSTOMERID	Integer	Yes	Unique customer identifier provided by NEA.
AMOUNT	String	Yes	Amount to be paid for the service.