Оплата

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

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

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

`https://plugin.{URL_сервера}/? label=label &currency_code=BTN &lang=lang &wallet_type=bnb_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=bnb_ml
currency_code=BTN
Доступные языки (lang): en, es (испанский)

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

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

URL: https://api.{domain}/api/v1/transaction/create/bnb_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": "BTN",
  "label": "eligen1di1"
}

{
    "status": "ok",
    "params": {
        "Wallet number": "wallet_number",
        "Account name": "Account_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	Код валюты (BTN).
wallet_type	string	yes	190	bnb_ml
label	string	yes	190	Это уникальный идентификатор (ID) пользователя, осуществляющего платеж.
key1	string	yes	12	Номер транзакции, полученный от пользователя. Длина 12 цифр.
screenshot	file	yes		Скриншот оплаты от пользователя.
amount	int	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"
}

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

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

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

{
    "signature": "92a8aa6aabda4cffe9fcfc595a28c321c91d36b2",
    "wallet_type": "bnb_ml",
    "amount": 300,
    "currency_code": "BTN",
    "label": "labeluser",
    "direction": "ingoing",
    "created_datetime": "2026-01-27 09:32:02",
    "access_key": "uowkn0b3LfBxpcWYHi4_",
    "additional_data": [
        {
            "activated_datetime": "2026-01-27 09:32:01",
            "exchanger_identifier": null,
            "comment": "",
            "amount": "300",
            "currency_code": "BTN",
            "wallet_type": "bnb_ml",
            "stockpiling_id": 12057,
            "transaction_id": "293397556789",
            "transaction_type": 0,
            "plugin_custom_order_id": "custom12345",
            "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.

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

Выплаты пользователям осуществляются через метод Sinpe Movil (подробнее про метод Sinpe Movil смотрите здесь).