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

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

Наименование метода:

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 следующего вида -
{ '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


Did this page help you?