Stock Broker

This API enables third-party systems or apps to integrate stock broker 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": {
            "stockBrokerList": [
                {
                    "brokerId": 34,
                    "brokerName": "Vision Securities Pvt. Limited",
                    "memberId": "611"
                },
                {
                    "brokerId": 49,
                    "brokerName": "Online Securities Pvt.Ltd",
                    "memberId": "611"
                },
                {
                    "brokerId": 58,
                    "brokerName": "Naasa Securities Company Ltd",
                    "memberId": "611"
                }
            ]
        }
    }
}

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}",
    "toMemberId": "{MemberId}",
    "amount": "1",
    "description": "Stock Broker Payment",
    "currencyId": "1",
    "webRequest": true,
    "customValues": [
        {
            "fieldId": "15",
            "internalName": "PAYMENTMETHOD",
            "value": "Mobile Wallet"
        },
        {
            "fieldId": "21",
            "internalName": "CUSTOMERID",
            "value": "18930349400"
        },
        {
            "fieldId": "33",
            "internalName": "MOBILENUMBER",
            "value": "18930349400"
        },
        {
            "fieldId": "174",
            "internalName": "NAME",
            "value": "test name"
        }
    ]
}

Book Payment – Successful Response (Sample)

{
    "status": true,
    "sessionExpired": false,
    "payload": {
        "DoPaymentResult": {
            "wouldRequireAuthorization": false,
            "from": {
                "id": 14838,
                "name": "test username",
                "username": "75453",
                "mobileNo": "9860606060"
            },
            "to": {
                "id": 611,
                "name": "test name2",
                "username": "28170",
                "email": "test@gmail.com",
                "mobileNo": "9841414141"
            },
            "finalAmount": 1.00,
            "formattedFinalAmount": "Rs. 1.00",
            "transferType": {
                "id": 405,
                "name": "Wallet Stock Broker",
                "from": {
                    "id": 14,
                    "name": "Mobile Wallet",
                    "currency": {
                        "id": 1,
                        "symbol": "रु",
                        "name": "Nepalese Rupee"
                    }
                },
                "to": {
                    "id": 5,
                    "name": "Transaction Account",
                    "currency": {
                        "id": 1,
                        "symbol": "रु",
                        "name": "Nepalese Rupee"
                    }
                }
            },
            "customValues": [
                {
                    "internalName": "PAYMENTMETHOD",
                    "fieldId": 15,
                    "value": "Mobile Wallet"
                },
                {
                    "internalName": "CUSTOMERID",
                    "fieldId": 21,
                    "value": "18930349400"
                },
                {
                    "internalName": "MOBILENUMBER",
                    "fieldId": 33,
                    "value": "18930349400"
                },
                {
                    "internalName": "NAME",
                    "fieldId": 174,
                    "value": "Rahul Karanjit"
                }
            ],
            "isOtpEnable": false,
            "showConsolidateAmount": false
            "bookingId": 23
        }
    }
}

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}",
    "toMemberId": "{MemberId}",
    "amount": "1",
    "description": "Stock Broker Payment",
    "traceNumber": "CEL-123456" //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": 23,
    "transactionPin": "123456",
    "customValues": [
        {
            "fieldId": "15",
            "internalName": "PAYMENTMETHOD",
            "value": "Mobile Wallet"
        },
        {
            "fieldId": "21",
            "internalName": "CUSTOMERID",
            "value": "18930349400"
        },
        {
            "fieldId": "33",
            "internalName": "MOBILENUMBER",
            "value": "18930349400"
        },
        {
            "fieldId": "174",
            "internalName": "NAME",
            "value": "Rahul Karanjit"
        }
    ]
}

Confirm Payment – Successful Response (Sample)

{
    "status": true,
    "sessionExpired": false,
    "payload": {
        "ConfirmPaymentResult": {
            "id": 151512,
            "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
brokerId	Integer	Yes	Unique identifier assigned to the broker.
brokerName	String	Yes	Registered name of the broker.
memberId	Integer	Yes	Unique identity number of the member registered with CellPay.
name	String	Yes	Full name of the customer associated with the transaction.
customerId	Integer	Yes	Unique identifier assigned to the customer in the system.
mobileNumber	String	Yes	Customer’s registered mobile number.