Оплата

1. Пользователю предоставляются реквизиты кошелька, на которые необходимо совершить оплату.
2. Пользователь совершает оплату в своем приложении кошелька и получает уникальный номер транзакции.
3. Далее пользователь вводит уникальный номер транзакции в платежном окне - активирует транзакцию.
4. Paykassma отсылает постбек на сторону мерчанта.
5. Средства начисляются на баланс пользователя на платформе мерчанта. 

Интеграция через платежное окно (plugin)

Пример ссылки на открытие платежного окна Ipay Manual:

wallet_type=ipay_manual
currency_code=PKR
Доступные языки (lang): en, si (сингальский)

Описание всех параметров плагина смотрите здесь.

Интеграция через клиентский API

Создание платежа

URL: https://api.{ URL сервера }/api/v1/transaction/create/ipay_manual?secret={pluginapi_secret}

В данном случае сначала мы принимаем запрос на ввод по платежной системе. Далее в ответе мы предоставим реквизиты кошелька, на который пользователь должен перевести платеж. После оплаты Вам необходимо отправить запрос на активацию транзакции.

Request method:

POST

Format:
JSON

Parameters:

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

{ 
    'status': 'ok', 
    'params':  { 
        'identifier': '0734234201'
    } 
}

{
    'status': 'fail',
    'message': 'MESSAGE'
}

Запрос активации

URL: http://api.{ 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'
}

Постбек депозита

Общую документацию по постбекам смотрите здесь.

Пример постбека на депозит Ipay Manual

{
    "signature": "2ad41735cd2d225cb30fe0665e83a3ade8618e0d",
    "wallet_type": "ipay_manual",
    "amount": 1000,
    "currency_code": "LKR",
    "label": "545932754",
    "converted_amount": {
"USD": 3.44, "INR": 287, "EUR": 3.26, , . . . , "USDTTRC20": 0, "USDT20": 0
},
    "direction": "ingoing",
    "created_datetime": "2023-09-26 19:37:02",
    "access_key": "TA25Ea9sjPUFJvIG",
    "additional_data": [
        {
          "activated_datetime": "2023-09-26 22:37:00",
          "exchanger_identifier": null,
          "comment": "",
          "amount": "1000",
          "currency_code": "LKR",
          "wallet_type": "ipay_manual",
          "stockpiling_id": 4819603,
          "transaction_id": "56052385",
          "transaction_type": 0,
          "plugin_custom_order_id": "5586199250",
          "withdrawal_id": null,
          "withdrawal_status": null,
          "account_number": "",
          "account_name": "",
          "account_email": "",
          "bank_details": {
               "bank_code": "",
               "branch_code": "" 
        }
    ]
}

Выводы / выплаты пользователям

Общую документацию по выводам смотрите здесь.

Создание вывода

URL: https://api.{ URLсервера }/api/v2/withdrawal/create

Request method:

POST

Format:
JSON

Parameters:

{
    "withdrawal_id": "1234567test565856",
    "payment_system": "ipay_manual",
    "amount": 10000,
    "currency_code": "LKR",
    "label": "125199",
    "account_number": "03405138",
    "account_name": "Test Name Acc",
    "is_test": true,
    "bank_details": {
        "bank_code": "Bank Of Ceylon"
    },
    "signature": "2e56786153bec935220fa1e9409ab24bd99cf9e8"
}

{
    "status": "ok",
}

{
    'status': 'fail',
    'message': 'MESSAGE'
}

*Если при попытке создания заявки на вывод сумма балансов счетов в валюте заявки будет меньше, чем общая сумма новой и еще незавершенных заявок, то отобразится ошибка 'Недостаточный баланс' (для настройки данного функционала обратитесь в ТП Paykassma).

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

Список актуальных банков

Alliance Finance Company PLC
Amana 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
Citibank
CLC
Citi bank N. A.
Citizen Development Bank
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

Пример постбека на вывод Ipay Manual

{
    "signature": "c698b4961e4bfd93957c3144647f4a6704960f03",
    "wallet_type": "ipay_manual",
    "amount": 10000,
    "currency_code": "LKR",
    "label": "125199",
    "converted_amount": {
    "USD": 30.63, "INR": 2553, "EUR": 28.07, "USDTTRC20": 0, "USDT20": 0
    },
    "direction": "outgoing",
    "created_datetime": "2023-11-19 21:39:01",
    "access_key": "icK2pOJnH7wxSZy9jmLslGeo",
    "additional_data": [
        {
            "activated_datetime": "",
            "exchanger_identifier": "",
            "comment": "test",
            "amount": "10000",
            "currency_code": "LKR",
            "wallet_type": "ipay_manual",
            "stockpiling_id": null,
            "transaction_id": "",
            "transaction_type": null,
            "plugin_custom_order_id": "",
            "withdrawal_id": "1234567test565856",
            "withdrawal_status": 5,
            "account_number": "03405138",
            "account_name": "Test Name Acc",
            "account_email": "",
            "bank_details": {
            "bank_code": "Bank Of Ceylon",
            "branch_code": null
                      }
        }
     ]
}

После обработки вывода Paykassma пришлет постбек о результате вывода со статусом, подписанный сигнатурой.

Статусы выводов

Создание заявки на выплату в ЛК Paykassma

Для создания заявки на вывод, необходимо перейти на страницу Выводы (Оплаты → Выводы) и выполнить следующие шаги:

1. Нажмите на кнопку "Добавить заявку на вывод".
   
   
   
2. Выберите из списка нужную ПС.
   
   
   
   
3. Заполните поля для создания заявки в следующем окне (список полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).
   Обязательные поля для выплаты Ipay Manual:
   - Лейбл (ID пользователя);
   - Сумма;
   - Валюта;
   - Кошелек получателя.
   
   
   
   4. После оплаты статус вывода поменяется.
   
   
   
   Paykassma не высылает постбек по выводам, созданным вручную.