Payment

1. The user is provided with wallet details to which payment must be made.
2. The user makes a payment in their wallet app and receives a unique transaction number.
3. Next, the user enters a unique transaction number in the payment window, after which the transaction is activated.
4. Paykassma sends a postback to the merchant's side.
5. 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:

wallet_type=banktransfer_manual
 currency_code=LKR
Available languages (lang): en, si

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:

{
  'currency': 'LKR',
  'label': 'eligendi'
}

{
    "status": "ok",
    "params": {
        "Account number": "066013529665120",
        "Bank name": "Seylan [Mathugama]",
        "Holder name": "K A PALITHA",
        "is_check_amount": null
    }
}

{
    '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:

{
    "status": "success",
    "message": "",
    "code": 20000,
    "data": [],
    "paginate": {
        "offset": 0,
        "total": 1,
        "limit": 1
    }
}

{
    '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

{
  "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": ""
      }
    }
  ]
}

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:

{
  "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"
}

{
    "status": "ok",
}

{
    '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).

{
    "status": "fail",
    "message": {
        "withdrawals_sum_amount": [
            "Insufficient balance"
        ]
    }
}

List of current banks

Example of a withdrawal postback for a Bank Transfer Manual

{
  "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
      }
    }
  ]
}

Withdrawal statuses

Creating withdrawal request in Paykassma BO

To create a withdrawal request, you need to go to the Withdrawals page Payments  → Withdrawals and perform the following steps

1. Press the button "Add withdrawal request".
   
   
   
2. Select payment system from list.
   
   
   
   
3. 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.