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

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

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