These docs are for v3.0. Click to read the latest docs for v4.0.

Вывод средств через явно указанный шлюз выплаты

Сначала вы должны выбрать шлюз для выплаты. Вы можете получить список доступных шлюзов и выбрать нужную вам услугу, используя

Наименование метода: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