Page History
Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Payment
- The user is provided with wallet details to which payment must be made.
- The user makes a payment in their wallet app and receives a unique transaction number.
- Next, the user enters a unique transaction number in the payment window, after which the transaction is activated.
- Paykassma sends a postback to the merchant's side.
- Funds are credited to the user’s balance on the merchant platform.
Payment window integration (plugin)
Example of a link to open a Bank Transfer Manual payment window:
|
---|
Code Block |
---|
wallet_type=banktransfer_manual currency_code=LKR Available languages (lang): en, si |
Info |
---|
Pay attention to the description of the parameters payment_url_success_id / payment_url_fail_id/ payment_url_pending_id and success_url / fail_url / pending_url. |
For the description of all the plug-in parameters click here.
API integration
Creating payment
URL: https://api.{server_URL}/api/v1/transaction/create/banktransfer_manual?secret={pluginapi_secret}
At this stage we first accept a request for input through the payment system and in response we will provide the wallet details to which the user should transfer the payment. After the payment is made you will need to send a request to activate the transaction.
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Max Length | Description |
currency | string | yes | 3 | Currency code. |
label | string | yes | 190 | The unique identifier (ID) of the user who makes the payment. |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ 'currency': 'LKR', 'label': 'eligendi' } |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "status": "ok", "params": { "Account number": "066013529665120", "Bank name": "Seylan [Mathugama]", "Holder name": "K A PALITHA", "is_check_amount": null } } |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ 'status': 'fail', 'message': 'MESSAGE' } |
Activation request
URL: http://api.{server_URL}/api/v1/possible-transaction?secret={pluginapi_secret}
Request method:
POST
Format:
form-data
Parameters:
Name | Type | Required | Max Length | Description |
currency_code | string | yes | 3 | Currency code (LKR). |
wallet_type | string | yes | 190 | banktransfer_manual |
label | string | yes | 190 | The unique identifier (ID) of the user who makes the payment. |
key1 | string | yes | 25 | Transaction ID received from the use (6-20, lettersand digits). |
screenshot | file | yes | Screenshot of the payment from the user. | |
amount | int | yes | 256 | Payment amount. |
custom_transaction_id | string | yes | 190 | The identifier of the transaction in the Client's system. Must be unique. |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "status": "success", "message": "", "code": 20000, "data": [], "paginate": { "offset": 0, "total": 1, "limit": 1 } } |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ 'status': 'fail', 'message': 'MESSAGE' } |
Deposit postback
For the general documentation on post backs click here.
Example of a deposit postback for a Bank Transfer Manual
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "signature": "76d0a2c6dadb2fc87d2dbdcb50809e9fb3cbc691", "wallet_type": "banktransfer_manual", "amount": 10000, "currency_code": "LKR", "label": "1234", "converted_amount": { "USD": 33.2, "INR": 2776, . . . , "USDT": 33.17921909, "USDTTRC20": 0, "USDT20": 0 }, "direction": "ingoing", "created_datetime": "2024-04-18 19:20:59", "access_key": "UevIJHFpWVoL0ad4x6CAnQ8R", "additional_data": [ { "activated_datetime": "2024-04-18 22:20:58", "exchanger_identifier": null, "comment": "", "amount": "10000", "currency_code": "LKR", "wallet_type": "banktransfer_manual", "stockpiling_id": 204, "transaction_id": "01003246080588218368", "transaction_type": 0, "plugin_custom_order_id": "test1234", "withdrawal_id": null, "withdrawal_status": null, "account_number": "", "account_name": "", "account_email": "", "bank_details": { "bank_code": "", "branch_code": "" } } ] } |
Warning |
---|
The Paykassma server is waiting for a response in json {"status": "ok"} response code 200, otherwise, when receiving a different response, Paykassma will forward the postback with a certain frequency. |
Withdrawals for users
For the general documentation on the withdrawals of funds click here.
Creating withdrawal
URL: https://api.{ server_URL }/v2/withdrawal/create
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Description |
withdrawal_id | string | yes | Withdrawal ID, if the parameter is not passed, then the system generates withdrawal _id. |
payment_system | string | yes | Payment system. |
amount | int | required | Additional requirements:
|
currency_code | string | yes | Currency code. |
label | string | yes | The unique identifier (ID) of the user who makes the payment. |
account_number | string | yes | Bank Transfer Manual wallet number. Validation:
|
account_name | string | yes | Name of account holder. |
bank_details.bank_code | string | yes | The bankfrom the providedlist of banks. |
is_test | boolean | yes | The is_test parameter possible values:
|
signature | string | yes | Signature generated with private_key. |
Code Block | ||||
---|---|---|---|---|
| ||||
{ "withdrawal_id": "test12345678", "payment_system": "banktransfer_manual", "amount": 4000, "currency_code": "LKR", "label": "test", "account_number": "100670008622", "account_name": "AWAKA N V S", "bank_details": { "bank_code": "Nations Trust Bank" }, "signature": "83722f5c8c963d7f7a6e5bbe0d1f13a4761927c4" } |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "status": "ok", } |
Code Block | ||||
---|---|---|---|---|
| ||||
{ 'status': 'fail', 'message': 'MESSAGE' } |
*If, when trying to create a withdrawal request, the amount of account balances in the currency of the request is less than the total amount of new and still incomplete applications, the error message"Insufficient balance" will be displayed (to configure this functionality, contact the TS Paykassma).
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "status": "fail", "message": { "withdrawals_sum_amount": [ "Insufficient balance" ] } } |
List of currentbanks
Alliance Finance Company PLCAmana Bank PLC
Asia Asset Finance PLC
Bank of Ceylon
Bank of China Limited
Bimputh Finance PLC
CBC Finance Limited
Cargills Bank Limited
CDB
Central Finance PLC
Citi bank N. A.
Citizen Development Bank
Citibank
CLC
Commercial Bank of Ceylon PLC
DFCC Commercial Bank PLC
Deutsche Bank AG
DFCC Bank
Dialog Finance PLC
HDFC Bank
HNB Finance PLC
HSBC
Fintrex Finance Limited
Habib Bank Limited
Hatton National Bank PLC
HDFC Bank
HSBC
Indian Bank
Indian Overseas Bank
Kanrich LB Finance Limited
L B Finance PLCLOFC
LOLC Development Finance
LOLC Finance PLC
Lanka Credit Finance LTD
MCB Bank Limited
Mercantile Investments
Merchant Merchant Bank of Sri Lanka & Finance PLC
Nations Trust Bank PLC
National Development BankNDB Bank
HNB Finance Limited
NSB
National Savings Bank
Pan Asia Bank PLCPABC
People Leasing Finance's Bank
Peoples Bank
Polgahawela Co-op BankPeople’s Leasing and Finance PLC
Public Bank Berhad
Regional Development Bank
Richard Piers Finance
Sampath Bank PLC
Sarvodhaya FinanceState Bank of India
SDB Bank (Sanasa)
Senkadagala Finance PLC
Seylan Bank PLC
Singer Finance PLC
Siyapatha Finance PLC
Softologic Finance PLC
Standard Chartered Bank
State Bank of India
Softologic Finance PLC
Standard Chartered Bank
State Bank of India
State Mortgage Bank
Union Bank Of Colombo PLC
Vallibel Finance PLC
Sanasa Development Bank
Fintrex Finance LimitedSinger Finance
Union Bank of Colombo PLC
Example of a withdrawal postback for a Bank Transfer Manual
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "signature": "74ead14ec43203fdd41d08cc10d96959241b4aaa", "wallet_type": "banktransfer_manual", "amount": 4000, "currency_code": "LKR", "label": "test", "converted_amount": { "USD": 13.28, "INR": 1110, "EUR": 12.48, ... , "USDTTRC20": 0, "USDT20": 0 }, "direction": "outgoing", "created_datetime": "2024-04-18 19:42:01", "access_key": "UevIJHFpWVoL0ad4x6CAnQ8R", "additional_data": [ { "activated_datetime": "", "exchanger_identifier": "", "comment": "", "amount": "4000", "currency_code": "LKR", "wallet_type": "banktransfer_manual", "stockpiling_id": null, "transaction_id": "", "transaction_type": null, "plugin_custom_order_id": "", "withdrawal_id": "test12345678", "withdrawal_status": 1, "account_number": "100670008622", "account_name": "AWAKA N V S", "account_email": "", "bank_details": { "bank_code": "Nations Trust Bank", "branch_code": null } } ] } |
Warning |
---|
The Paykassma server is waiting for a response in json {"status": "ok"} response code 200, otherwise, when receiving a different response, Paykassma will forward the postback with a certain frequency. |
Withdrawal statuses
1 | SUCCESS | Status for withdrawal when the withdrawal request has been successfully processed. |
5 | FAIL | Status for withdrawal when the withdrawal request was rejected. |
Creating withdrawal request in Paykassma BO
To create a withdrawal request, you need to go to the Withdrawals pagePayments → Withdrawals and perform the following steps
- Press the button "Add withdrawal request".
- Select payment system from list.
- Fill in the fields to create the request in the next window(the list of fields is standardized and not all fields are required. To create a request for a specific PS, you should fill in the required fields for this PS).
Required fields for Bank Transfer Manual withdrawal:
- Label (user ID);
- Amount;
- Currency;
- Wallet recipient.
4. After payment the withdrawal status will change.
Paykassma does not send postback for withdrawals created manually.
Table of Contents | ||
---|---|---|
|