Оплата

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

Оглавление:



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

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

https://plugin.{URL_сервера}/?
label=label
&currency_code=PYG
&lang=lang
&wallet_type=itau_ml
&custom_transaction_id=custom_transaction_id
&fixed_amount=fixed_amount
&payment_url_success_id=2
&payment_url_pending_id=3
&payment_url_fail_id=1
&success_url=hash
&fail_url=hash
&pending_url=hash


wallet_type=itau_ml
currency_code=PYG
Доступные языки (lang): en, 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/itau_ml?secret={pluginapi_secret}

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

Request method:

POST

Format:
JSON

Parameters:

Name

Type

Required

Max Length

Description

currencystringyes3Код валюты.

label

string

yes

190

Это уникальный идентификатор (ID) пользователя, осуществляющего платеж.


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


{
    "status": "ok",
    "params": {
        "Account number": "220000000",
        "Account name": "Account Test Name",
        "is_check_amount": null
    }
}


{
    '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_codestringyes3Код валюты (PYG).

wallet_type

string

yes

190

itau_ml
labelstringyes190Это уникальный идентификатор (ID) пользователя, осуществляющего платеж.
key1stringyes10Номер транзакции полученный от пользователя. Длина от 6 до 10 цифр.
screenshotfileyes
Скриншот оплаты от пользователя.
amountintyes256Сумма платежа.
custom_transaction_id

string

yes190

Идентификатор транзакции в системе Клиента.

Должен быть уникальным.


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


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

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

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

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

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


Сервер 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_idstringyes Идентификатор вывода, если параметр не передается, то система генерирует withdrawal_id.
payment_systemstring yesПлатежная система.
amount

int


required

Дополнительные требования:

  1. amount >= величина установленного минимального значения;
  2. amount <= величина установленного максимального значения.
currency_codestringyesКод валюты.

label

string

yes

Label пользователя, для которого проводится вывод. 

account_numberstring 

yes

Номер счета пользователя в банке Itau (от 7 до 9 цифр). 

account_namestring

yes

Имя и Фамилия держателя счета.

is_test

booleanyes

Параметр is_test может принимать одно из двух значений:

  • true - если вывод тестовый;
  • false - если вывод реальный.
signaturestringyesПодпись, формируемая с private_key.


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


{
    "status": "ok",
}


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

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

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

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

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


Сервер Paykassma ожидает ответ в json {"status":"ok"} код ответа 200, в противном случае, при получении отличающегося ответа, Paykassma будет пересылать постбек с определенной периодичностью.
На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200.

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

ID

Название

Описание

1

PROCESSED 

Статус для вывода, когда заявка на вывод была успешно обработана.

5

REJECTED

Статус для вывода, когда заявка на вывод была отклонена.

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

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

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

  4. После оплаты статус вывода поменяется. 

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