Traffic Fine Payment

This API enables third-party systems or apps to integrate traffic fine payment 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": {
            "fiscalYearList": [
                {
                    "display": "2078/79",
                    "value": "7879"
                },
                {
                    "display": "2077/78",
                    "value": "7778"
                },
                {
                    "display": "2076/77",
                    "value": "7677"
                }
            ]
        }
    }
}

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": "10",
    "description": "ok",
    "currencyId": "1",
    "webRequest": true,
    "customValues": [
        {
            "internalName": "PAYMENTMETHOD",
            "fieldId": "15",
            "value": "Mobile Wallet"
        },
        {
            "internalName": "CUSTOMERID",
            "fieldId": "21",
            "value": "{{customerId}}"
        }
    ],
    "extraParam": {
        "code": "7879"
    }
}

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": 165980.00,
            "formattedFinalAmount": "NPR 165,980.00",
            "fees": [
                {
                    "type": "FEE",
                    "name": "Fee on Government(10001 - above)",
                    "amount": 20.00,
                    "formattedAmount": "NPR 20.00",
                    "description": "Applied Fee"
                }
            ],
            "transferType": {
                "id": {{transferTypeId}},
                "name": "{{transferTypeName}}",
                "title": "{{transferTypeTitle}}",
                "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": "CUSTOMERID",
                    "fieldId": 21,
                    "value": "{{customerId}}"
                },
                {
                    "internalName": "PAYMENTMETHOD",
                    "fieldId": 15,
                    "value": "Mobile Wallet"
                }
            ],
            "isOtpEnable": false,
            "advanceValues": {
                "creditorName": "{{creditorName}}",
                "particulars": "{{particular}}",
                "remarks": "{{remarks}}",
                "referenceId": "{{referenceId}}"
            },
            "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": "10",
    "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": 33,
    "transactionPin": "XXXXXX",
    "customValues": [
        {
            "internalName": "PAYMENTMETHOD",
            "fieldId": "15",
            "value": "Mobile Wallet"
        },
        {
            "internalName": "CUSTOMERID",
            "fieldId": "21",
            "value": "{{customerId}}"
        }
    ],
    "extraParam": {
        "code": "7879"
    }
}

Confirm Payment – Successful Response (Sample)

{
    "status": true,
    "sessionExpired": false,
    "payload": {
        "ConfirmPaymentResult": {
            "id": 138065,
            "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	Data Type	Required	Description
CUSTOMERID	Integer	Yes	Unique customer identifier, representing the chit number issued by the Traffic Police.
Amount	String	Yes	Total fine amount to be paid. The value must match the amount issued against the corresponding chit number.