Вывод средств на баланс мобильного оператора

Данный метод позволяет вывести средства с гривневого счета Kuna.io на баланс украинских мобильных операторов ( Kyivstar, Vodafone, Lifecell).

Для вывода средств на баланс мобильного оператора необходимо воспользоваться общим подходом для вывода фиатных средств с явным указанием шлюза вывода

Вывод средств с явным указанием шлюза вывода

Сначала необходимо получить доступ к сервисам выплат, используя POST https://api.kuna.io/v3/auth/withdraw/prerequest с параметром currency - код валюты в нижнем регистре (uah).

json
{
    "common": {
        "services": [
            {
                "code": "payment_card_uah",
                "method": "payment_card",
                "currency": "UAH",
                "fields": [
                    {
                        "key": "card_number",
                        "type": "string",
                        "label": {
                            "ru": "Номер карты",
                            "en": "Card number",
                            "uk": "Номер карти"
                        },
                        "example": null,
                        "hint": {
                            "ru": "Введите номер карты",
                            "en": "Enter card number",
                            "uk": "Введіть номер карти"
                        },
                        "regexp": "^\\\\d{12,19}$",
                        "required": true,
                        "position": 0
                    }
                ],
                "amount_min": 100,
                "amount_max": 25000,
                "exchange_rate": 1,
                "amount": "10.00",
                "fee": {
                    "rate": 1.5,
                    "fixed": 0,
                    "min": 0,
                    "max": 0
                }
            },
            {
                "code": "geopaynet_uah",
                "method": "geopaynet",
                "currency": "UAH",
                "fields": [
                    {
                        "key": "user_id",
                        "type": "string",
                        "label": {
                            "ru": "ID пользователя",
                            "en": "User ID",
                            "uk": "ID користувача"
                        },
                        "example": null,
                        "hint": {
                            "ru": "Введите GEO ID пользователя",
                            "en": "Enter GEO User ID",
                            "uk": "Введіть GEO ID користувача"
                        },
                        "regexp": "^[a-f0-9]{64}$",
                        "required": true,
                        "position": 0
                    }
                ],
                "amount_min": 10,
                "amount_max": 100000,
                "exchange_rate": 1,
                "amount": "10.00",
                "fee": {
                    "rate": 0,
                    "fixed": 2,
                    "min": 0,
                    "max": 0
                }
            },
            {
                "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{1,15}$",
                        "required": true,
                        "position": 0
                    }
                ],
                "amount_min": 100,
                "amount_max": 60000,
                "exchange_rate": 2.55099,
                "amount": "25.51",
                "fee": {
                    "rate": 0,
                    "fixed": 0,
                    "min": 0,
                    "max": 0
                }
            }
        ],
        "methods": [
            {
                "code": "payment_card",
                "category": "payment_card",
                "description": "",
                "name": {
                    "en": "VISA MasterCard",
                    "ru": "VISA MasterCard",
                    "uk": "VISA MasterCard"
                },
                "logo": "https://kuna.io/images/visa_ukraine.svg",
                "icon": "https://static.openfintech.io/payout_methods/payment_card/icon.svg",
                "metadata": [],
                "position": 0,
                "hide": null
            },
            {
                "code": "geopaynet",
                "category": "alternative",
                "description": "",
                "name": {
                    "en": "GEO Pay",
                    "ru": "GEO Pay",
                    "uk": "GEO Pay"
                },
                "logo": "https://kuna.io/images/geo.svg",
                "icon": "https://static.openfintech.io/payout_methods/geopaynet/icon.svg",
                "metadata": [],
                "position": 2,
                "hide": null
            },
            {
                "code": "qiwi",
                "category": "digital_wallet",
                "description": "",
                "name": {
                    "en": "QIWI",
                    "ru": "QIWI",
                    "uk": "QIWI"
                },
                "logo": "https://kuna.io/images/qiwi.svg",
                "icon": "https://static.openfintech.io/payment_methods/qiwi/icon.svg",
                "metadata": [],
                "position": 1,
                "hide": null
            }
        ]
    }
}

Необходимо выбрать нужный вам сервис (result ['common'] ['services']) и сохранить его code и fields ['key'], поэтому для mobile_uah это будет код mobile_uah и поле phone.

Затем следует выполнить

POST https://api.kuna.io/v3/auth/withdraw

с параметрами

Параметр

withdraw_type

код валюты в нижнем регистре (uah)

amount

сумма для вывода

gateway

название сервиса, которое будет использоваться для вывода средств, это название сервиса из пререквеста выплаты

fields

phone

withdrawall

необязательный параметр, установите его «true» или «1», если пользователь хочет снять все средства со счета, указывает, что комиссионные уже включены в сумму. Например, пользователь хочет снять 1000 гривен, а комиссия составляет 1%, поэтому, если снятие равно false или 0, общая сумма вывода составит 100 + 1% = 101, а пользователь получит 100 гривен. В случае вывода «true» или «1» общая сумма вывода составит 100, но пользователь получит только 99,01 грн, а сумма комиссии составит 0,99 грн.

callback_url

  • optional
    URL обратного вызова, который сможет обрабатывать POST-запросы при успешном или неудачном выводе средств.
json
{
    "withdraw_type": "uah",
    "amount": 100,
    "gateway": "mobile_uah",     (т.е. название метода)
    "fields": { 
        phone: ‘<номер телефона>’ (например 06534567891) 
    "callback_url": 'https://callback.url'
    }
}
json
[
    {
        "status": "awaiting_confirmation",
        "message": "Your withdrawal request has been successfully submitted.",
        "withdrawal_id": 259267,
        "amount": 100.0
    }
]

Вы должны сохранить значение result['withdrawal_id'] для использования в качестве id для получения деталей вывода.

В колбеке приходят параметры

address:

бин карты, номер кошелька, криптовый адрес

id

ID вывода

currency:

Валюта вывода

amount

Сумма вывода

memo:

Memo для криптовалют

state:

`done' или 'canceled'


Did this page help you?