Create - создать платеж

Описание запроса на создание платежа

Request

POST https://bovatech.cc/v1/p2p_transactions

JSON Request Params

Name	Type	Description
user_uuid*	string	Токен, который можно получить в ЛК (Профиль -> Интеграция -> User ID)
merchant_id*	string	Ваш номер транзакции
payeer_identifier*	string	Идентификатор пользователя (плательщика) в виде строки в любом формате
payeer_ip*	string	IP-адрес пользователя (плательщика)
payeer_type*	string	Первичный или вторичный трафик. Указывается: "ftd" или "trust". "trust" - минимум 3 депозита и 2 вывода у пользователя, остальные все "ftd".
currency*	string	Валюта транзакции: rub uzs krw kgs azn ars inr jpy mdl
payment_method*	string	Способ пополнения: rub: card sberpay sbp account_number crysis international qr_nspk alfaclick click uzs: card krw: account_number kgs: card sbp azn: card ars: account_number azn: international_azn card inr: upi_id upi_intent jpy: account_number mdl: sbp
payeer_bank_name	string	Для метода click RUB: "sberbank" | "tinkoff" | "alfabank"
amount*	integer	Сумма в выбранной валюте, указанная при создании транзакции
callback_url*	string	URL обратного вызова для получения callback уведомлений. Запрос POST с ретраем при условии получения не 200 http status code.
redirect_url	string	Ссылка для редиректа пользователя с формы оплаты после завершения платежа
email	string	Email плательщика (если имеется)
customer_name	string	Имя плательщика (если имеется)
payeer_first_name	string	Имя плательщика (Только для KRW)
payeer_last_name	string	Фамилия плательщика (Только для KRW)
payeer_bank_name	string	Банк отправителя для KGS SBP подбирается такой же банк
card_brand	string	Предпочитаемая платежная система: humo, uzcard

Headers

Name	Type	Description
Content-Type	string	Всегда application/json
Signature	string	Подпись вычисляется для каждого запроса с помощью выданного вам api_key токена

Example Request:

{
    "user_uuid": "0091e581-d96f-478b-be98-51937b66204d",
    "merchant_id": "a6631ecaa-7ad1-162b-91c2-458dfd6e0e73",
    "amount": 500,
    "callback_url": "https://webhook.site/cfe48fa4-dd15-4a8b-a318-c918e94cb020",
    "redirect_url": "https://ya.ru/", 
    "email": "[email protected]", 
    "customer_name": "Ivan Vasiliev", 
    "currency": "rub", 
    "payeer_identifier": "payeer_identifier123",
    "payeer_ip": "127.0.0.1",
    "payeer_type": "trust",
    "payment_method": "card"
}

JSON Response Params:

Name	Type	Description
id	string	ID транзакции на стороне BOVA
merchant_id	string	Ваш номер транзакции
form_url	string	Ссылка на форму оплаты BOVA
state	string	Статус транзакции
created_at	string	Дата создания транзакции
updated_at	string	Дата последнего обновления транзакции
close_at	string	Дата закрытия транзакции по таймауту
currency	string	Валюта транзакции
payment_method	string	Способ пополнения
callback_url	string	URL обратного вызова для получения callback уведомлений
redirect_url	string	Ссылка для редиректа пользователя с формы оплаты после завершения платежа
email	string	Email плательщика
customer_name	string	Имя плательщика
amount	decimal	Сумма транзакции в USDT после конвертации по курсу
fiat_amount	decimal	Сумма в выбранной валюте, указанная при создании транзакции
old_fiat_amount	decimal	Сумма в выбранной валюте, указанная при создании транзакции (неизменна)
rate	decimal	Курс конвертации currency/usdt
service_commission	decimal	Процент Вашей комиссии
total_amount	decimal	Сумма к зачислению на баланс за вычетом комиссии системы при зачислении транзакции
resipient_card	object	Данные о реквизите для использования H2H

Example Response:

{
  "result_code": "ok",
  "payload": {
    "id": "666b32d60ad6fe9cc30bb0f2c3497976f29ec8d8",
    "merchant_id": "a6631ecaa-7ad1-162b-91c2-458dfd6e0e73",
    "currency": "rub",
    "form_url": "https://pay.bovapay.eu/666b32d60ad6fe9cc30bb0f2c3497976f29ec8d8",
    "state": "waiting_payment",
    "created_at": "2024-04-08T14:06:00.471+03:00",
    "updated_at": "2024-04-08T14:06:00.516+03:00",
    "close_at": "2024-04-08T14:16:00.248+03:00",
    "callback_url": "https://webhook.site/cfe48fa4-dd15-4a8b-a318-c918e94cb020",
    "redirect_url": "https://ya.ru/",
    "email": "[email protected]",
    "customer_name": "Ivan Vasiliev",
    "rate": "94.98",
    "amount": "5.26",
    "fiat_amount": "500.0",
    "old_fiat_amount": "500.0",
    "service_commission": "6.5",
    "total_amount": "4.9181",
    "payment_method": "card",
    "resipient_card": {
      "id": "41fa3334-0e17-46db-b1a4-22cd5b2d5422",
      "number": "4111111111111111",
      "bank_name": "sberbank",
      "bank_full_name": "Сбербанк",
      "bank_colors": {},
      "brand": null,
      "card_holder": "Ivan Ivanov",
      "payment_method": "card",
      "url": "https://qr.nspk.ru/BD20005UNQFQL4MBF12ARJ3RPITR5KKCF?type=02&bank=100000000017&sum=200000&cur=RUB&crc=F33B",
      "updated_at": "2024-04-08T14:06:00.248+03:00",
      "created_at": "2024-04-08T14:06:00.248+03:00",
      "sberpay_url": null
    }
  }
}

State description:

Name	Type	Description
waiting_payment	internal	Ожидает оплаты
paid	internal	Отмечен оплаченным (пользователем)
successed	final	Успешно по зачислению (callback)
accepted_successed	final	Успешно после подтверждения апелляции (callback)
repeated_accepted_successed	final	Успешно после подтверждения повторной апелляции (callback)
failed	final	Отклонена по таймауту, зачисление не найдено (callback)
closed_failed	final	Отклонена после отклонения апелляции (callback)
repeated_closed_failed	final	Отклонена после отклонения повторной апелляции (callback)
reviewing	internal	Транзакция имеет активную апелляцию на рассмотрении
repeated_reviewing	internal	Транзакция имеет активную повторную апелляцию на рассмотрении