Оплата
- Пользователю предоставляются реквизиты кошелька, на которые необходимо совершить оплату.
- Пользователь совершает оплату в своем приложении кошелька и получает уникальный номер транзакции.
- Далее пользователь вводит уникальный номер транзакции в платежном окне - активируется транзакции.
- Paykassma отсылает постбек на сторону мерчанта.
- Средства начисляются на баланс пользователя на платформе мерчанта.
Интеграция через платежное окно (plugin)
Пример ссылки на открытие платежного окна Ipay:
https://plugin.{URL_сервера}/?label=label¤cy_code=LKR&lang=en&wallet_type=ipay&custom_transaction_id=custom_transaction_id&fixed_amount=fixed_amount&payment_url_fail_id=1 |
|---|
wallet_type=ipay currency_code=LKR Доступные языки (lang): en, si(Сингальский)
Обратите внимание на описание параметров payment_url_success_id / payment_url_fail_id / payment_url_pending_id и success_url / fail_url / pending_url
Для использования payment_url_success_id / payment_url_fail_id / payment_url_pending_id необходимо передать URL'ы саппорту Paykassma, и использовать полученные ID в параметрах.
Для использования success_url / fail_url / pending_url необходимо использовать хеширование URL'ов (подробнее про хеширование см. здесь).
Описание всех параметров плагина смотрите здесь.
Интеграция через клиентский API
Создание платежа
URL: https://api.{URL_сервера}/api/v1/transaction/create/ipay?secret={pluginapi_secret}
В данном случае сначала мы принимаем запрос на ввод по платежной системе. Далее в ответе мы предоставим реквизиты кошелька, на который пользователь должен перевести платеж. После оплаты Вам необходимо отправить запрос на активацию транзакции.
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Max Length | Description |
| currency | string | yes | 3 | Код валюты. |
label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж. |
{
"currency": "LKR",
"label": "eligendi"
}
{
'status': 'ok',
'params': {
'identifier': '0734234234'
}
}
{
'status': 'fail',
'message': 'MESSAGE'
}
Запрос активации
URL: http://api.{URL_сервера}/api/v1/transaction/activate?secret={pluginapi_secret}
На данном этапе пользователь передает номер транзакции, который вы пересылаете на сторону Paykassma для активации.
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Max Length | Description |
| currency_code | string | yes | 3 | Код валюты |
wallet_type | string | yes | 190 | Значение из списка доступных ПС, например: easypaisa и тд. |
| label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж |
| key1 | string | yes | 190 | Transaction_ID, полученный от пользователя (8 цифр) |
| amount | int | yes | 256 | Сумма платежа |
| custom_transaction_id | string | yes | 190 | Идентификатор транзакции в системе Клиента. Должен быть уникальным. |
{
"currency_code": "LKR",
"label": "786442",
"wallet_type": "ipay",
"key1": "23936785",
"amount": 1000,
"custom_transaction_id": "3158538"
}
{
"status": "ok",
"deposit": true,
"deposit_amount": 100,
"currency": {
"code": "LKR",
"symbol": "LKR"
}
}
{
"status": "pending",
"message": "The deposit status check has been started. The operation may take longer than expected. Upon completion of the verification, the funds will be credited to your account"
}
{
"status": "possible_transaction_created",
"message": "Transaction not found. Possible transaction created"
}
{
'status': 'fail',
'message': 'MESSAGE'
}
Постбек депозита
Общую документацию по постбекам смотрите здесь.
Пример постбека на депозит Ipay
На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200.
Выводы / выплаты пользователям
Общую документацию по выводам смотрите здесь.
Создание вывода Ipay
URL: https://api.{URL_сервера}/v2/withdrawal/create
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Description |
| withdrawal_id | string | yes | Идентификатор вывода, если параметр не передается, то система генерирует withdrawal_id. |
| payment_system | string | yes | Платежная система. |
| amount | int | required | Дополнительные требования:
|
| currency_code | string | yes | Код валюты. |
label | string | yes | Label пользователя, для которого проводится вывод. |
| account_number | string | yes | Номер счёта пользователя в Ipay. Валидация:
|
| account_name | string | yes | Имя держателя аккаунта. |
is_test | boolean | yes | Параметр is_test может принимать одно из двух значений:
|
| signature | string | yes | Подпись, формируемая с private_key. |
{
"withdrawal_id": "1234567test565856",
"payment_system": "ipay",
"amount": 10000,
"currency_code": "LKR",
"label": "125199",
"account_number": "0718448214",
"account_name": "Test Name Acc",
"is_test": true,
"signature": "2e56786153bec935220fa1e9409ab24bd99cf9e8"
}
{
"status": "ok"
}
{
'status': 'fail',
'message': 'MESSAGE'
}
*Если при попытке создания заявки на вывод сумма балансов счетов в валюте заявки будет меньше, чем общая сумма новой и еще незавершенных заявок, то отобразится ошибка 'Недостаточный баланс' (для настройки данного функционала обратитесь в ТП Paykassma).
{
"status": "fail",
"message": {
"withdrawals_sum_amount": [
"Insufficient balance"
]
}
}
Пример постбека на вывод Ipay
На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200.
После обработки вывода, Paykassma пришлет постбек о результате вывода со статусом, подписанный сигнатурой.
Статусы выводов
| 1 | SUCCESS | Статус для вывода, когда заявка на вывод была успешно обработана. |
| 5 | FAIL | Статус для вывода, когда заявка на вывод была отклонена. |
Создание заявки на выплату в ЛК Paykassma
Для создания заявки на вывод, необходимо перейти на страницу Выводы (Оплаты → Выводы) и выполнить следующие шаги:
- Нажмите на кнопку "Добавить заявку на вывод".
- Выберите из списка нужную ПС.
- Заполните поля для создания заявки в следующем окне (Cписок полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).
Обязательные поля для выплаты Ipay:
- Лейбл (ID пользователя);
- Сумма;
- Валюта;
- Кошелек получателя.
- После оплаты статус вывода поменяется.
Paykassma не высылает постбек по выводам, созданным вручную.