Оплата
- Пользователю предоставляются реквизиты кошелька, на которые необходимо совершить оплату.
- Пользователь совершает оплату в своем приложении кошелька и получает уникальный номер транзакции.
- Далее пользователь вводит уникальный номер транзакции в платежном окне для подтверждения платежа.
- Paykassma отсылает постбек на сторону мерчанта.
- Средства начисляются на баланс пользователя на платформе мерчанта.
Интеграция через платежное окно (plugin)
Пример ссылки на открытие платежного окна Transferencia bancaria:
|
|---|
wallet_type=brou_ml currency_code=UYU Доступные языки (lang): es (испанский)
Обратите внимание на описание параметров 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/brou_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) пользователя, осуществляющего платеж. |
{
"currency": "UYU",
"label": "eligendi"
}
{
"status": "ok",
"params": {
"Bank name": "Bank name",
"Wallet number": "1864712567",
"Holder name": "Holder name",
"is_check_amount": null
}
}
{
"status": "fail",
"message": "MESSAGE"
}
Запрос активации
URL: https://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 | Код валюты (UYU). |
wallet_type | string | yes | 190 | brou_ml |
| label | string | yes | 190 | Это уникальный идентификатор (ID) пользователя, осуществляющего платеж. |
| key1 | string | yes | 16 | Номер транзакции, полученный от пользователя. Длина от 4 до 15 цифр. |
| amount | number | yes | 256 | Сумма платежа. |
| custom_transaction_id | string | yes | 190 | Идентификатор транзакции в системе Клиента. Должен быть уникальным. |
{
"status": "success",
"message": "",
"code": 20000,
"data": [],
"paginate": {
"offset": 0,
"total": 1,
"limit": 1
}
}
{
"status": "fail",
"message": "MESSAGE"
}
Постбек депозита
Общую документацию по постбекам смотрите здесь.
Пример постбека на депозит Transferencia bancaria
{
"signature": "i49eg2cvtub6jef9jd94qv8ie4sx",
"wallet_type": "brou_ml",
"amount": 5000,
"currency_code": "UYU",
"label": "label",
"direction": "ingoing",
"created_datetime": "2025-11-29 10:17:16",
"access_key": "uowkn11f1dscWYHi4_",
"additional_data": [
{
"activated_datetime": "2025-11-29 10:19:25",
"exchanger_identifier": null,
"comment": "",
"amount": "5000",
"currency_code": "UYU",
"wallet_type": "brou_ml",
"stockpiling_id": 11855,
"transaction_id": "6813524",
"transaction_type": 0,
"plugin_custom_order_id": "orderid",
"withdrawal_id": null,
"withdrawal_status": null,
"account_number": "",
"account_name": "",
"account_email": "",
"bank_details": {
"bank_code": "",
"branch_code": ""
}
}
]
}
На повторные постбеки необходимо также отвечать {"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 | numeric | required | Дополнительные требования:
|
| currency_code | string | yes | Код валюты. |
label | string | yes | Label пользователя, для которого проводится вывод. |
| account_number | string | yes | Номер счета получателя. Длина от 4 до 20 цифр. |
| account_name | string | yes | Имя и Фамилия держателя счета. |
| bank_details.bank_code | string | required | Банк из предоставленного списка банков.
|
is_test | boolean | yes | Параметр is_test может принимать одно из двух значений:
|
| signature | string | yes | Подпись, формируемая с private_key. |
{
"withdrawal_id": "71300252575802",
"payment_system": "brou_ml",
"amount": 50,
"currency_code": "UYU",
"label": "testuser",
"account_number": "9062580551",
"account_name": "Account Name",
"bank_details": {
"bank_code": "Nations Trust Bank"
},
"is_test": false,
"signature": "drco400v16bqv9b9yvivqwgqi5g3caqgxmty0h6"
}
{
"status": "ok",
}
{
"status": "fail",
"message": "MESSAGE"
}
*Если при попытке создания заявки на вывод сумма балансов счетов в валюте заявки будет меньше, чем общая сумма новой и еще незавершенных заявок, то отобразится ошибка 'Недостаточный баланс' (для настройки данного функционала обратитесь в ТП Paykassma).
{
"status": "fail",
"message": {
"withdrawals_sum_amount": [
"Insufficient balance"
]
}
}
Список актуальных банков
Пользователь должен выбрать банк только из предложенного списка. Ручной ввод названия банка пользователем запрещен.
BROU
Santander
Scotiabank
BBVA
HSBC
Heritage
Citibank
Banco Nación Argentina (BNA)
BHU
Prex
MiDinero
OCA Blue
Mercado Pago
Пример постбека на вывод Transferencia bancaria
{
"signature": "1msyizm7kb62imruc5pcbs4b01qcj2nvv4fbnh3e",
"wallet_type": "brou_ml",
"amount": 5000,
"currency_code": "UYU",
"label": "testuser",
"direction": "outgoing",
"created_datetime": "2025-11-29 14:39:45",
"access_key": "uoe12nb3LfBxpcWYHi4_8",
"additional_data": [
{
"activated_datetime": "",
"exchanger_identifier": "",
"comment": "1",
"amount": "5000",
"currency_code": "UYU",
"wallet_type": "brou_ml",
"stockpiling_id": null,
"transaction_id": "",
"transaction_type": null,
"plugin_custom_order_id": "",
"withdrawal_id": "5677931",
"withdrawal_status": 1,
"account_number": "1864712567",
"account_name": "Account Name",
"account_email": "",
"bank_details": {
"bank_code": null,
"branch_code": null
}
}
]
}
На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200.
Статусы выводов
ID | Название | Описание |
|---|---|---|
1 | PROCESSED | Статус для вывода, когда заявка на вывод была успешно обработана. |
5 | REJECTED | Статус для вывода, когда заявка на вывод была отклонена. |
Создание заявки на выплату в ЛК Paykassma
Для создания заявки на вывод, необходимо перейти на страницу Выводы (Оплаты → Выводы) и выполнить следующие шаги:
- Нажмите на кнопку "Добавить заявку на вывод".

- Выберите из списка нужную ПС.

- Заполните поля для создания заявки в следующем окне (Cписок полей стандартизирован и не все поля являются обязательными. Для создания заявки по определенной ПС, необходимо заполнить обязательные поля для этой ПС).
Обязательные поля для выплаты Transferencia bancaria:
- Лейбл (ID пользователя);
- Сумма;
- Валюта;
- Кошелек получателя;
- Имя получателя.
- После оплаты статус вывода поменяется.

Paykassma не высылает постбек по выводам, созданным вручную.