Вывод средств через явно указанный шлюз выплаты
Сначала вы должны выбрать шлюз для выплаты. Вы можете получить список доступных шлюзов и выбрать нужную вам услугу, используя
Наименование метода: | https://api.kuna.io/v3/auth/withdraw/prerequest |
Тип запроса: | POST |
Параметры: | currency - код валюты в нижнем регистре (uah, rub, usd) |
Вы получите набор доступных сервисов вывода, например (для RUB):
{
"common": {
"services": [
{
"code": "qiwi_rub",
"method": "qiwi",
"currency": "RUB",
"fields": [
{
"key": "wallet_id",
"type": "string",
"label": {
"ru": "Номер телефона",
"en": "Phone number",
"uk": "Номер телефону"
},
"example": null,
"hint": {
"ru": "Введите номер телефона Qiwi кошелька",
"en": "Enter phone number",
"uk": "Введіть номер телефону Qiwi гаманця"
},
"regexp": "^\\\\+\\\\d{10,14}$",
"required": true,
"position": 0
}
],
"amount_min": 1,
"amount_max": 60000,
"exchange_rate": 1,
"amount": "10.00",
"fee": {
"rate": 1,
"fixed": 0,
"min": 0,
"max": 0
},
"verification_stage": null
}
],
"methods": [
{
"code": "qiwi",
"category": "digital_wallet",
"description": "",
"name": {
"en": "Qiwi",
"ru": "Qiwi",
"uk": "Qiwi"
},
"logo": "https://static.openfintech.io/payout_methods/qiwi/logo.svg",
"icon": "https://static.openfintech.io/payout_methods/qiwi/icon.svg",
"metadata": null,
"position": null,
"hide": null,
"verification_stage": null
}
]
}
}
Необходимо выбрать нужный сервис (из раздела services
) и сохранить его code
иfields ['key']
. К примеру, для вывода через QIWI, вам нужен код qiwi_rub
и название поля wallet_id
Затем необходимо создать вывод с использованием выбранного сервиса и обязательных полей
Наименование метода: | https://api.kuna.io/v3/auth/withdraw |
Тип запроса: | POST |
Статус запроса | статус успеха: 200 в случае ошибки: 400 с JSON следующего вида - json { 'messages': ['error_message_1', 'error_message_2', ...] } |
Входящие параметры:
withdraw_type | код валюты в нижнем регистре (uah, rub, usd) |
amount | сумма вывода |
gateway | название шлюза для выплат, полученного в предыдущем запросе (например, для QIWI - qiwi_rub) |
withdrawall | Необязательный параметр. Установите его true или 1 , если пользователь хочет вывести все средства со счета, указывая эта сумма уже включает сумму комиссии.Установите его false или 0 , если пользователь хочет получить указанную сумму. Конечная сумма будет увеличена на сумму комиссии. |
fields | Название платежного поля (номер карты, кошелька, телефона) и его значение. Например, для QIWI: { 'wallet_id': '<номер телефона>' } |
Пример для вывода RUB на кошелек QIWI:
{
"withdraw_type": "rub",
"amount": 100,
"gateway": "qiwi_rub",
"fields": { "wallet_id": "+380661234567" }
}
Возращаемое значение:
[
{
"status": "awaiting_confirmation",
"message": "Your withdrawal request has been successfully submitted.",
"withdrawal_id": 259267,
"amount": 100.0
}
]
Возможные статусы ответа
awaiting_confirmation | Пользователю нужно подтвердить вывод через имейл |
pending | Обработка |
done | Вывод успешен |
canceled | Вывод отменен |
unknown | Неизвестная ошибка. Следует обратиться в поддержку Kuna.io |
Updated over 3 years ago