Вывод средств через шлюз выплаты по умолчанию
Наименование метода: | 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 | обязательное значение default |
withdrawall | Необязательный параметр. Установите его true или 1 , если пользователь хочет вывести все средства со счета, указывая эта сумма уже включает сумму комиссии.Установите его false или 0 , если пользователь хочет получить указанную сумму. Конечная сумма будет увеличена на сумму комиссии.Например, пользователь хочет снять 1000 грн, а комиссия составляет 1%, поэтому если withdrawall указано false или 0 , то общая сумма снятия составит 100 + 1% = 101, а пользователь получит 100 грн.В случае если withdrawall указано true или 1 , то общая сумма будет 100, но пользователь получит только 99.01 грн, а комиссия составит 0.99 грн. |
withdraw_to | Номер карты |
Пример использования:
{
withdraw_type: 'uah',
amount: 100.0,
gateway: 'default',
withdraw_to: '4111111111111111' // CC number
}
$response_data['request_data'] = [
'withdraw_type' => 'btc',
'amount' => $amount,
'withdrawall' => true,
'address' => $address,
];
$body_string_arr = [];
foreach ($response_data['request_data'] as $key => $value) {
$body_string_arr[] = $key . '=' . $value;
}
$body_string = http_build_query($request_data);
$url = "https://api.kuna.io/v3/auth/withdraw";
$nounce = round(microtime(true) * 1000);
$signature = '/v3/auth/withdraw' . $nounce . $body_string;
$sig = hash_hmac('SHA384', $signature, $kuna_secret_key);
$headers = [
'kun-nonce: ' . $nounce,
'kun-apikey: ' . $kuna_api_key,
'kun-signature: ' . $sig,
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body_string);
$res = curl_exec($ch);
curl_close($ch);
$res_array = json_decode($res, TRUE);
Возращаемое значение:
[
{
"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 4 years ago