SSF Payment
This API enables third-party systems or apps to integrate SSF Payment services into their systems via CellPay.
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 Example
{
"submissionNo": "{{submissionNo}}",
"employeeId": "{{employeeId}}"
}
Get Possible Values – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"possibleValues": {
"submissionNo": "{{submissionNo}}",
"employeeId": "{{employeeId}}",
"employeeNameNepali": "{{employeeNameNepali}}",
"employeeNameEnglish": "{{employeeNameEnglish}}",
"year": 2076,
"month": 7,
"email": "test50841602@test.com",
"amount": 18872.8,
"toMemberPrincipal": "{{toMemberPrincipal}}",
"status": false
}
}
}
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": "18872.8",
"description": "Self Transfer Large Merchant",
"currencyId": "1",
"toMemberPrincipal": "{{to-member-principal}}",
"webRequest": "true",
"customValues": [
{
"fieldId": "15",
"internalName": "PAYMENTMETHOD",
"value": "Mobile Wallet"
},
{
"fieldId": "288",
"internalName": "EMPLOYEE_ID",
"value": "{{employeeId}}"
}
],
"extraParam": {
"submissionNo": "{{submissionNo}}"
},
"isOtpEnable": false
}
Book Payment – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"DoPaymentResult": {
"wouldRequireAuthorization": false,
"from": {
"id": {{fromMemberId}},
"name": "{{fromMemberName}}",
"username": "{{fromMemberUsername}}",
"mobileNo": "",
"premiumMember": false
},
"to": {
"id": 350269,
"name": "KHALTI PVT LTD",
"username": "khalti",
"mobileNo": "6666666666",
"premiumMember": false
},
"finalAmount": 18872.80,
"formattedFinalAmount": "Rs. 18,872.80",
"transferType": {
"id": 618,
"name": "Merchant Wallet SSF Payment",
"title": "Merchant Wallet SSF Payment",
"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": "EMPLOYEE_ID",
"fieldId": 288,
"value": "20801305249"
}
],
"isOtpEnable": false,
"advanceValues": {
"amount": 18872.8,
"year": 2076,
"mobileNumber": "",
"employeeId": "{{employeeId}}",
"sessionId": "368",
"employeeNameInEnglish": "{{employeeNameEnglish}}",
"cellpayTransactionId": "CEL1770526778513",
"month": 7,
"employeeNameInNepali": "{{employeeNameNepali}}",
"submissionNo": "{{submissionNo}}",
"email": "test50841602@test.com",
"status": true
},
"showConsolidateAmount": false,
"extraParam": {
"eventId": 0,
"subEventId": 0,
"disableOtp": false,
"renewOption": false,
"submissionNo": "{{submissionNo}}"
},
"bookingId": "{{bookingId}}"
}
}
}
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": "18872.8",
"description": "Self Transfer Large Merchant",
"currencyId": "1",
"toMemberPrincipal": "{{to-member-principal}}",
"webRequest": "true",
"transactionPin": "{{login-password}}",
"traceNumber": "CEL-123456", //Use consistent transaction IDs like CELL-001 or PRV-001 per your company's standard. Trace Number must be unique.
"bookingId": "{{bookingId-data}}",
"customValues": [
{
"fieldId": "15",
"internalName": "PAYMENTMETHOD",
"value": "Mobile Wallet"
},
{
"internalName": "EMPLOYEE_ID",
"fieldId": 288,
"value": "20801305249"
}
],
"extraParam": {
"submissionNo": "{{submissionNo}}",
"employeeId": "{{employeeId}}",
"cellpayTransactionId": "{{referenceId}}",
"sessionId": "{{sessionId}}"
},
"isOtpEnable": false
}
Confirm Payment – Successful Response (Sample)
{
"status": true,
"sessionExpired": false,
"payload": {
"ConfirmPaymentResult": {
"id": 175964,
"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.
}
}
}