Create - создать выплату

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

Request

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

JSON Request Params

Name	Type	Description
user_uuid*	string	Токен, который можно получить в ЛК (Профиль -> Интеграция -> User ID)
merchant_id*	string	Ваш номер транзакции
currency*	string	Валюта транзакции: rub uzs krw azn kgs tjs ars inr jpy mdl
payment_method*	string	Метод оплаты: rub: card card_fast sbp sbp_fast account_number sber_sbor sim uzs: card krw: account_number azn: card card_international kgs: card sbp tjs: card ars: account_number inr: imps jpy: account_number mdl: sbp
amount*	integer	Сумма в выбранной валюте, указанная при создании выплаты
callback_url*	string	URL обратного вызова для получения callback уведомлений. Запрос POST с ретраем при условии получения не 200 http status code
to_card*	string	Реквизит для получения выплаты. Если sbp – номер телефона получателя Если card – номер каты получателя Если card_fast – номер каты получателя Если account_number – номер счета получателя Если sber_sbor – указать "none" Если imps – номер счета получателя
bik	string	*Банковский идентификационный код (JPY account_nummber)
sbp_bank_name	string	При создании выплаты по методу sbp, нужно указать номер телефона в формате [phone] в поле – to_card и код банка назначения НСПК в поле – sbp_bank_name. Можно взять от сюда: https://qr.nspk.ru/proxyapp/c2bmembers.json Пример: 100000000111 – Сбербанк 100000000004 – Т-Банк (Тинькофф) 110000000005 – ВТБ 100000000001 – Газпромбанк 100000000008 – Альфа Банк 100000000013 – Совкомбанк 100000000015 – Банк Открытие 100000000016 – Почта Банк 100000000273 – Озон Банк 100000000150 – Яндекс Банк 100000000284 – Банк Точка 100000000059 – Центр-инвест Для RUB SIM коды операторов такие: 801 – Билайн 802 – МТС 803 – РСК Банк (Eldic Bank) 804 – Оптима Банк 805 – Bakai Bank 806 – Demir Bank Для KGS SBP коды банков такие: 10014 – MBANK 10009 – Банк Компаньон 10090 – РСК Банк (Eldic Bank) 19001 – Оптима Банк 19002 – Bakai Bank 19003 – Demir Bank 19004 – O Bank 19005 – Simbank Для MDL SBP коды банков такие: M001 – Moldova Agroindbank M002 – Moldindconbank M003 – Victoriabank M004 – Mobiasbanca OTP Group M005 – ProCredit Bank Moldova M006 – Eximbank Intesa Sanpaolo M007 – Banca Comerciala Romana Chisinau M008 – Energbank M009 – EuroCreditBank M010 – FinComBank
bank_name	string	*Только для KRW направления код банка из предложенных: 1 - ABN AMRO 2 - BANK OF AMERICA 3 - BNK SECURITIES CO 4 - BNP Paribas 5 - BNPPKR 6 - BOOKOOK 7 - Bank of Korea 8 - Barclays 9 - Busan Bank 10 - China Construction Bank 11 - Citibank Korea 12 - Credit Union 13 - DAESHIN 14 - DB FINANCIAL INVESTMENT CO., LTD 15 - DEUTSCHE BANK 16 - DMS Bank 17 - Daegu Bank 18 - HANKOOK 19 - HANWHA 20 - HITOOJA 21 - HSBC 22 - Hana Financial Investment 23 - Hyundai Motor Securities 24 - IBK 25 - ING 26 - Industrial & Commercial Bank of China 27 - JPMORGAN CHASE 28 - Jeju Bank 29 - Jeonbuk Bank 30 - K Bank 31 - KB Securities 32 - KDB 33 - KEB Hana Bank 34 - KIWOOM 35 - KOREAN FEDERATION OF COMMUNITY CREDIT COOPERATIVES 36 - KTB Investment 37 - KYOBO TRADE 38 - Kakao Bank 39 - Kookmin Bank 40 - Korea Development Bank 41 - Korea Foss Securities 42 - Kwangju Bank 43 - Kyungnam Bank 44 - MERITZ 45 - MIRAEASSET DAEWOO 46 - NH INVESTMENT 47 - National Agricultural Cooperative Federation 48 - Nonghyup Bank 49 - Post Bank 50 - SAMSUNG 51 - SANLIM 52 - SC First Bank 53 - SHINYOUNG 54 - SKTRADE 55 - Saemaeul Bank 56 - Shinhan Bank 57 - Shinhan Investment Corp 58 - Standard Chartered Bank 59 - Suhyup Bank 60 - Woori Bank 61 - YOUJIN TRADE 62 - YUANTA 63 - dmsgod Mutual Savings Bank 64 - eBEST Investment Securities Co, Ltd 65 - kakaopay securities *Только для JPY направления код банка из предложенных: J001 - Mitsubishi UFJ Bank (三菱UFJ銀行) J002 - Mizuho Bank (みずほ銀行) J003 - Sumitomo Mitsui Bank (三井住友銀行) J004 - Japan Post Bank (ゆうちょ銀行) J005 - Rakuten Bank (楽天銀行) J006 - Sony Bank (ソニー銀行) J007 - SBI Sumishin Net Bank (住信SBIネット銀行) J008 - Aeon Bank (イオン銀行) J009 - Resona Bank (りそな銀行) J010 - Shizuoka Bank (静岡銀行) J011 - Chiba Bank (千葉銀行) J012 - Hokuhoku Financial Group (ほくほくフィナンシャルグループ) J013 - Fukuoka Financial Group (ふくおかフィナンシャルグループ) J014 - Yucho Bank (ゆうちょ銀行) J015 - Japan Net Bank (PayPay銀行 / ジャパンネット銀行) J016 - Okinawa Bank (沖縄銀行) J017 - Kansai Mirai Bank (関西みらい銀行) J018 - Hachijuni Bank (八十二銀行) J019 - Aozora Bank (あおぞら銀行) J020 - Shinsei Bank (新生銀行) J021 - Norinchukin Bank (農林中央金庫) J022 - Bank of Yokohama (横浜銀行) J023 - Kyoto Bank (京都銀行) J024 - Gunma Bank (群馬銀行) J025 - Hiroshima Bank (広島銀行) J026 - Bank of Nagoya (名古屋銀行) J027 - Nishi-Nippon City Bank (西日本シティ銀行) J028 - Toho Bank (東邦銀行) J029 - Iyo Bank (伊予銀行) J030 - Musashino Bank (武蔵野銀行) J031 - Yamaguchi Bank (山口銀行) J032 - Shiga Bank (滋賀銀行) J033 - Daishi Hokuetsu Bank (第四北越銀行) J034 - Kansai Urban Banking Corporation (関西アーバン銀行) J035 - Kiyo Bank (紀陽銀行) J036 - Juroku Bank (十六銀行) J037 - Hyakugo Bank (百五銀行) J038 - Ashikaga Bank (足利銀行) J039 - Fukushima Bank (福島銀行) J040 - Tochigi Bank (栃木銀行) J041 - Yamagata Bank (山形銀行) J042 - Ehime Bank (愛媛銀行) J043 - Aomori Bank (青森銀行) J044 - North Pacific Bank (北洋銀行) J045 - Hokkaido Bank (北海道銀行) J046 - Bank of Fukuoka (福岡銀行) J047 - Bank of Kagoshima (鹿児島銀行) J048 - Hyakujushi Bank (百十四銀行) J049 - Chugoku Bank (中国銀行) J050 - Bank of Saga (佐賀銀行) J051 - Miyazaki Bank (宮崎銀行) J052 - Bank of Iwate (岩手銀行) J053 - San-in Godo Bank (山陰合同銀行) J054 - Bank of Toyama (富山銀行) J055 - Hokkoku Bank (北國銀行) J056 - Bank of Okinawa (琉球銀行) J057 - Bank of Kyoto (京都銀行) J058 - Bank of Kochi (高知銀行) J059 - Bank of Nanto (南都銀行) J060 - Bank of Kumamoto (熊本銀行) *Только для ARS направления код банка из предложенных: mercadopago garpa lemon buenbit reba naranjax uala somosmodo personalpay prexcard brubank bancogalicia astropay belo ripio claropay lbfinanzas trubit *Только для INR направления название банка из предложенных: sbi pnb barodampay canarabank ubi boi indianbank centralbank iob uco mahabank hdfcbank icici axisbank kotak indus ybl fbl idfcnetc idbi rbl sib kvb dcb cub tmb bandhan csb sc hsbc dbi barclays dbs citi sbm fino airtel jio paytm nsdl au equitas ujjivan suryoday jana esaf utkarsh nesfb shivalik capital
recipient_first_name	string	*Только для KRW, AZN, INR, JPY направлений Имя получателя
recipient_last_name	string	*Только для KRW, AZN, INR, JPY направлений Фамилия получателя
ifsc	string	*Только для INR imps направления код IFSC

Headers

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

Example Request:

{
    "user_uuid": "364dbfc8-ae50-492f-bdd9-748edd84d5c9",
    "to_card": "4111111111111111",
    "bik": "BOJPJPJTXXX",
    "amount": 50000,
    "callback_url": "https://webhook.site/f3029e33-db04-40fd-a81e-5cea9a69fc80",
    "merchant_id": "40fd-a81e-f3029e33-5cea9a69fc80",
    "payment_method": "card",
    "currency": "rub"
}

JSON Response Params:

Name	Type	Description
id	string	ID транзакции на стороне BOVA
merchant_id	string	Ваш номер транзакции
state	string	Статус транзакции
created_at	string	Дата создания транзакции
updated_at	string	Дата последнего обновления транзакции
currency	string	Валюта транзакции
callback_url	string	URL обратного вызова для получения callback уведомлений
amount	decimal	Сумма транзакции в USDT после конвертации по курсу
fiat_amount	decimal	Сумма в выбранной валюте, указанная при создании выплаты
old_fiat_amount	decimal	Сумма в выбранной валюте, указанная при создании выплаты (неизменна)
rate	decimal	Курс конвертации currency/usdt
commission_type	string	relative – процент fixed – фиксированное количество USDT
service_commission	decimal	Процент Вашей комиссии
total_amount	decimal	Сумма к зачислению на баланс за вычетом комиссии системы при зачислении транзакции
bank_name	string	Банк карты получателя
sbp_bank_name	string	Код НСПК банка получателя (если выплата SBP)
payment_method	string	Метод выплаты
recipient_card	string	Реквизит получателя
form_url	string	Ссылка на форму sber_sbor

Example Response:

{
    "result_code": "ok",
    "payload": {
        "id": "1ab06cdd-24c8-4f59-903b-d31ad75e6ffc",
        "amount": "554.63",
        "commission_type": "relative",
        "service_commission": "3.0",
        "rate": "90.15",
        "fiat_amount": "50000.0",
        "old_fiat_amount": "50000.0",
        "state": "failed",
        "currency": "rub",
        "created_at": "2024-07-16T16:25:34.125+03:00",
        "updated_at": "2024-07-16T18:19:06.421+03:00",
        "total_amount": "571.2689",
        "account_id": 3456,
        "bank_name": "mts",
        "sbp_bank_name": null,
        "payment_method": "card",
        "recipient_card": "411111******1111",
        "form_url": null
    }
}

State description:

Name	Type	Description
created	internal	Выплата создана, ожидает начала обработки
processing	internal	Выплата в обработке, ожидает финализации
paid	final	Выплата выплачена
failed	final	Выплата не выплачена