Оплата

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

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

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

https://plugin.{URL_сервера}/?
label=label
&currency_code=CRC
&lang=lang
&wallet_type=baciban_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=baciban_ml
currency_code=CRC
Доступные языки (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/baciban_ml?secret={pluginapi_secret}

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

Request method:

POST

Format:
JSON

Parameters:

Name

Type

Required

Max Length

Description

currencystringyes3Код валюты.

label

string

yes

190

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


Request
{
  "currency": "CRC",
  "label": "eligendi"
}
Response Success
{
    "status": "ok",
    "params": {
        "Account number": "81351811",
        "is_check_amount": null
    }
}
Response Fail
{
    "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Код валюты (CRC).

wallet_type

string

yes

190

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

string

yes190

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

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

Response Success
{
    "status": "success",
    "message": "",
    "code": 20000,
    "data": [],
    "paginate": {
        "offset": 0,
        "total": 1,
        "limit": 1
    }
}
Response Fail
{
    "status": "fail",
    "message": "MESSAGE"
}

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

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

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

{
  "signature": "aa23231cf517cf8d49aedssd2dac0a96acefdb9f",
  "wallet_type": "baciban_ml",
  "amount": 1500,
  "currency_code": "CRC",
  "label": "label",
  "direction": "ingoing",
  "created_datetime": "2025-11-14 14:17:26",
  "access_key": "uoslc0b3Lf5s1pcWYHi4_",
  "additional_data": [
    {
      "activated_datetime": "2025-11-14 14:17:25",
      "exchanger_identifier": null,
      "comment": "",
      "amount": "1500",
      "currency_code": "CRC",
      "wallet_type": "baciban_ml",
      "stockpiling_id": 11855,
      "transaction_id": "40245745",
      "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": ""
      }
    }
  ]
}
Сервер Paykassma ожидает ответ в json {"status":"ok"} код ответа 200, в противном случае, при получении отличающегося ответа, Paykassma будет пересылать постбек с определенной периодичностью.
На повторные постбеки необходимо также отвечать {"status":"ok"} код ответа 200.

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

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