Page History
Интеграция через платежное окно (plugin)
Пример ссылки на открытие платежного окна Itau Paraguay Manual:
|
|---|
| Code Block |
|---|
wallet_type=itau_ml currency_code=PYG Доступные языки (lang): en, es (испанский) |
| Info |
|---|
Обратите внимание на описание параметров 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/itau_ml?secret={pluginapi_secret}
На данном этапе сначала мы принимаем запрос на ввод по платежной системе. Далее в ответе мы предоставим реквизиты кошелька, на который пользователь должен перевести платеж. А после оплаты Вам необходимо отправить запрос на активацию транзакции.
Request method:
POST
Format:
JSON
Parameters:
Name | Type | Required | Max Length | Description |
| currency | string | yes | 3 | Код валюты. |
label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'currency': 'PYG',
'label': 'eligendi'
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "ok",
"params": {
"Account number": "220000000",
"Account name": "Account Test Name",
"is_check_amount": null
}
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'status': 'fail',
'message': 'MESSAGE'
} |
Запрос активации
URL: http://api.{ 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 | Код валюты (PYG). |
wallet_type | string | yes | 190 | itau_ml |
| label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж. |
| key1 | string | yes | 10 | Номер транзакции полученный от пользователя. Длина от 6 до 10 цифр. |
| screenshot | file | yes | Скриншот оплаты от пользователя. | |
| amount | int | yes | 256 | Сумма платежа. |
| custom_transaction_id | string | yes | 190 | Идентификатор транзакции в системе Клиента. Должен быть уникальным. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "success",
"message": "",
"code": 20000,
"data": [],
"paginate": {
"offset": 0,
"total": 1,
"limit": 1
}
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
'status': 'fail',
'message': 'MESSAGE'
} |
Постбек депозита
Общую документацию по постбекам смотрите здесь.
Пример постбека на депозит Itau Paraguay Manual
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"signature": "50f7ad0d213b28e6f7fb7a19726e521d722ec500",
"wallet_type": "itau_ml",
"amount": 25000,
"currency_code": "PYG",
"label": "test_label1234",
"direction": "ingoing",
"created_datetime": "2025-11-11 15:38:48",
"access_key": "uowkn0b3LfBxpcWYHi4_",
"additional_data": [
{
"activated_datetime": "2025-11-11 15:38:47",
"exchanger_identifier": null,
"comment": "",
"amount": "25000",
"currency_code": "PYG",
"wallet_type": "itau_ml",
"stockpiling_id": 11844,
"transaction_id": "0394031",
"transaction_type": 0,
"plugin_custom_order_id": "test_custom1234",
"withdrawal_id": null,
"withdrawal_status": null,
"account_number": "",
"account_name": "",
"account_email": "",
"bank_details": {
"bank_code": "",
"branch_code": ""
}
}
]
} |
| Warning |
|---|
| Сервер Paykassma ожидает ответ в json {"status":"ok"} код ответа 200, в противном случае, при получении отличающегося ответа, Paykassma будет пересылать постбек с определенной периодичностью. На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200. |
Выводы / выплаты пользователям
Общую документацию по выводам смотрите здесь.
Создание вывода
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 | Номер счета пользователя в банке Itau (от 7 до 9 цифр). |
| account_name | string | yes | ФИО Имя и Фамилия держателя счета. |
is_test | boolean | yes | Параметр is_test может принимать одно из двух значений:
|
| signature | string | yes | Подпись, формируемая с private_key. |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"withdrawal_id": "test1129245631874491",
"payment_system": "itau_ml",
"amount": 75000,
"currency_code": "PYG",
"label": "testlabel12345",
"account_number": "220000000",
"account_name": "Ashik Bik",
"is_test": false,
"signature": "dd323cc90163d306ad97bc327cf482417a7af276"
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "ok",
} |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"status": "fail",
"message": "MESSAGE"
} |
*Если при попытке создания заявки на вывод сумма балансов счетов в валюте заявки будет меньше, чем общая сумма новой и еще незавершенных заявок, то отобразится ошибка 'Недостаточный баланс' (для настройки данного функционала обратитесь в ТП Paykassma).
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"status": "fail",
"message": {
"withdrawals_sum_amount": [
"Insufficient balance"
]
}
} |
Пример постбека на вывод Itau Paraguay Manual
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"signature": "adfba698ad218ef2a081a5744ecfb7787faef13e",
"wallet_type": "itau_ml",
"amount": 75000,
"currency_code": "PYG",
"label": "testlabel12345",
"direction": "outgoing",
"created_datetime": "2025-11-11 16:08:21",
"access_key": "uowkn0b3LfBxpcWYHi4_",
"additional_data": [
{
"activated_datetime": "",
"exchanger_identifier": "",
"comment": "",
"amount": "75000",
"currency_code": "PYG",
"wallet_type": "itau_ml",
"stockpiling_id": null,
"transaction_id": "",
"transaction_type": null,
"plugin_custom_order_id": "",
"withdrawal_id": "test11129245631874491",
"withdrawal_status": 1,
"account_number": "220000000",
"account_name": "Ashik Bik",
"account_email": "",
"bank_details": {
"bank_code": null,
"branch_code": null
}
}
]
} |
| Warning |
|---|
| Сервер Paykassma ожидает ответ в json {"status":"ok"} код ответа 200, в противном случае, при получении отличающегося ответа, Paykassma будет пересылать постбек с определенной периодичностью. На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200. |
Статусы выводов
ID | Название | Описание |
|---|---|---|
1 | PROCESSED | Статус для вывода, когда заявка на вывод была успешно обработана. |
5 | REJECTED | Статус для вывода, когда заявка на вывод была отклонена. |
Создание заявки на выплату в ЛК Paykassma
Для создания заявки на вывод, необходимо перейти на страницу Выводы (Оплаты → Выводы) и выполнить следующие шаги:
- Нажмите на кнопку "Добавить заявку на вывод".
- Выберите из списка нужную ПС.
- Заполните поля для создания заявки в следующем окне (Cписок полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).
Обязательные поля для выплаты Itau Paraguay Manual:
- Лейбл (ID пользователя);
- Сумма;
- Валюта;
- Кошелек получателя.
- После оплаты статус вывода поменяется.
Paykassma не высылает постбек по выводам, созданным вручную.