Вывод средств на баланс мобильного оператора
Данный метод позволяет вывести средства с гривневого счета 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' |
Updated over 4 years ago