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

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

Request

POST https://bovatech.cc/merchant/v1/deposits

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" или "verif_ftd" или "verif_trust". "trust" - минимум 3 депозита и 2 вывода у пользователя, остальные все "ftd". ftd trust verif_trust verif_ftd
currency*	string	Валюта транзакции: crypto rub uzs krw kgs tjs azn ars inr jpy mdl
payment_method	string	Способ пополнения: crypto_currency: crypto rub: card cent crysis sberpay sbp sbp_plus account_number international_card click qr_nspk p2p_market uzs: card click krw: account_number click p2p_market kgs: card sbp qrcode azn: card qrcode international_azn tjs: card ars: account_number click inr: upi_id upi_qr upi_intent jpy: account_number mdl: sbp
payeer_bank_name	string	Для метода click RUB: "sberbank" | "tinkoff" | "alfabank" | "vtb" | "ozon" | "yandex_bank" | "gazprombank" | "psb" | "solid" | "yoomoney" Для метода click UZS: "xazna" Для метода click ARS: "mercado_pago"| "claropay" Для метода international_card RUB: "sberbank" | "tinkoff" | "alfabank" | "vtb" Для метода KGS SBP: "mbank" | "bakai" | "optimabank" | "kompanion" Для метода KGS CARD: "mbank" | "bakai" | "optimabank" | "kompanion" Для метода KGS QRCODE: "mbank" Для метода KRW click: "kakaopay" | "toss"
amount*	integer	Сумма в выбранной валюте, указанная при создании транзакции
callback_url*	string	URL обратного вызова для получения callback уведомлений. Запрос POST с ретраем при условии получения не 200 http status code.
redirect_url	string	Ссылка для редиректа пользователя с формы оплаты после завершения платежа
email	string	Email плательщика (если имеется)
customer_name	string	Имя плательщика (если имеется)
card_brand	string	Предпочитаемая платежная система: humo, uzcard

Headers

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

Example Request:

{
    "user_uuid": "0091e581-d96a-478b-ac15-51937b66204c",
    "merchant_id": "string",
    "amount": 1000,
    "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
uuid	string	ID транзакции на стороне BOVA
merchant_id	string	Ваш номер транзакции
form_url	string	Ссылка на форму оплаты BOVA
tg_url	string	Ссылка на Telegram-бот для валюты UZS
state	string	Статус транзакции
created_at	string	Дата создания транзакции
updated_at	string	Дата последнего обновления транзакции
close_at	string	Дата закрытия транзакции по таймауту
currency	string	Валюта транзакции
callback_url	string	URL обратного вызова для получения callback уведомлений
redirect_url	string	Ссылка для редиректа пользователя с формы оплаты после завершения платежа.
source_transaction - payment_method	string	P2pTransaction или CryptoTransaction
source_transaction	object	Созданная транзакция внутри формы
source_transaction - email	string	Email плательщика
source_transaction - customer_name	string	Имя плательщика
source_transaction - amount	decimal	Сумма транзакции в USDT после конвертации по курсу
source_transaction - fiat_amount	decimal	Сумма в выбранной валюте, указанная при создании транзакции
source_transaction - old_fiat_amount	decimal	Сумма в выбранной валюте, указанная при создании транзакции (неизменна)
source_transaction - rate	decimal	Курс конвертации currency/usdt
source_transaction - service_commission	decimal	Процент Вашей комиссии
source_transaction - total_amount	decimal	Сумма к зачислению на баланс за вычетом комиссии системы при зачислении транзакции
source_transaction - payment_method	string	Способ пополнения

Example Response:

{
    "data": {
        "uuid": "77ae5d83-d5ca-4650-83d0-e0f1873cbda9",
        "merchant_id": "string",
        "amount": "10.99",
        "fiat_amount": "1000.0",
        "currency": "rub",
        "state": "processing",
        "selected_crypto_currency": null,
        "callback_url": "https://webhook.site/cfe48fa4-dd15-4a8b-a318-c918e94cb020",
        "redirect_url": "https://ya.ru/",
        "created_at": "2024-08-19 15:38:24 +0300",
        "updated_at": "2024-08-19 15:38:25 +0300",
        "form_url": "https://pay.bovapay.eu/payments/77af5d83-d5cc-4650-83d0-e0c1873cbda9",
        "tg_url": "https://t.me/Bot_name_bot?start=77ae5d83-d5ca-4650-83d0-e0f1873cbda9",
        "source_transaction_class": "P2pTransaction",
        "source_transaction": {
            "id": "77af5d83-d5cc-4650-83d0-e0c1873cbda9",
            "merchant_id": "string",
            "currency": "rub",
            "state": "waiting_payment",
            "created_at": "2024-08-19 15:38:25 +0300",
            "updated_at": "2024-08-19 15:38:25 +0300",
            "close_at": "2024-08-19 15:48:25 +0300",
            "redirect_url": "https://ya.ru/",
            "email": "[email protected]",
            "customer_name": "Ivan Vasiliev",
            "rate": "91.1",
            "amount": "10.99",
            "fiat_amount": "1000.0",
            "old_fiat_amount": "1000.0",
            "payment_method": "card",
            "payeer_bank_name": null
        }
    },
    "errors": {},
    "message": null,
    "status": "ok",
    "meta": {}
}

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	Транзакция имеет активную повторную апелляцию на рассмотрении