API документация

API для работы с кошельком

Для работы с API кошелька необходимо сгенерировать ключ для доступа на странице https://www.fkwallet.ru/settings/

Все запросы отправляются методом POST на URL https://www.fkwallet.ru/api_v1.php, ответ в формате JSON

Получение баланса кошелька

Обязательные параметры:
wallet_id Ваш номер кошелька
sign Контрольная подпись MD5, формируется из вашего wallet_id и API ключа, например
md5('F123456789'.'JG68NC68DJC8S0DCH6')
action get_balance

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'sign'=>md5('F123456789'.'JG68NC68DJC8S0DCH6'),
        'action'=>'get_balance',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Wallet balance","data":{"RUR":"50.00","USD":"0.00","EUR":"0.00"}}

Вывод средств из кошелька

Обязательные параметры:
wallet_id Ваш номер кошелька
purse Кошелек для вывода
amount Сумма вывода
desc Примечание
currency Валюта для вывода
sign Контрольная подпись MD5, формируется из параметров wallet_id, currency, amount, purse и API ключа, например
md5('F123456789'.'64'.'10.23'.'79111111111'.'JG68NC68DJC8S0DCH6')
action cashout

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'purse'=>'79111111111',
        'amount'=>10.23,
        'desc'=>'Test payment',
        'currency'=>64,
        'sign'=>md5('F123456789'.'64'.'10.23'.'79111111111'.'JG68NC68DJC8S0DCH6'),
        'action'=>'cashout',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Payment send","data":{"payment_id":"543273"}}

Список доступных валют

1 WebMoney WMR (комиссия 4.50%)
2 WebMoney WMZ (комиссия 5.50%)
63 QIWI кошелек (комиссия 4.00%)
64 Perfect Money USD (комиссия 3.50%)
45 Яндекс.Деньги (комиссия 0.00%)
60 OKPAY RUB (комиссия 2.50%)
61 OKPAY EUR (комиссия 2.50%)
62 OKPAY USD (комиссия 2.50%)
69 Perfect Money EUR (комиссия 3.50%)
70 PayPal (комиссия 8.50%)
137 Мобильный Платеж МегаФон Северо-Западный филиал (комиссия 1.50%)
138 Мобильный Платеж МегаФон Сибирский филиал (комиссия 1.50%)
139 Мобильный Платеж МегаФон Кавказский филиал (комиссия 1.50%)
140 Мобильный Платеж МегаФон Поволжский филиал (комиссия 1.50%)
141 Мобильный Платеж МегаФон Уральский филиал (комиссия 1.50%)
142 Мобильный Платеж МегаФон Дальневосточный филиал (комиссия 1.50%)
143 Мобильный Платеж МегаФон Центральный филиал (комиссия 1.50%)
82 Мобильный Платеж Мегафон (комиссия 1.50%)
83 Мобильный Платеж Билайн (комиссия 1.50%)
84 Мобильный Платеж МТС (комиссия 1.50%)
87 OOOPAY USD (комиссия 1.00%)
94 VISA/MASTERCARD RUB (комиссия 4.00%)
132 Мобильный Платеж Tele2 (комиссия 1.50%)
106 OOOPAY RUR (комиссия 1.00%)
109 OOOPAY EUR (комиссия 1.00%)
114 PAYEER RUB (комиссия 4.50%)
133 FK WALLET RUB (комиссия 0.00%)
136 ADVCASH USD (комиссия 5.00%)
150 ADVCASH RUB (комиссия 3.00%)
157 VISA UAH CASHOUT (комиссия 5.00%)
158 VISA/MC INT (комиссия 3.00%)

Получение статуса операции вывода из кошелька

Обязательные параметры:
wallet_id Ваш номер кошелька
payment_id Номер операции полученный при отправке запроса
sign Контрольная подпись MD5, формируется из параметров wallet_id, payment_id и API ключа, например
md5('F123456789'.'543273'.'JG68NC68DJC8S0DCH6')
action get_payment_status

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'payment_id'=>'543273',
        'sign'=>md5('F123456789'.'543273'.'JG68NC68DJC8S0DCH6'),
        'action'=>'get_payment_status',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Order status","data":{"payment_id":"543273","status":"Canceled"}}

Список Статусов

New Новая
In process В процессе
Completed Выполнена
Canceled Отменена

Перевод на другой кошелек

Обязательные параметры:
wallet_id Ваш номер кошелька
purse Кошелек для перевода
amount Сумма перевода
sign Контрольная подпись MD5, формируется из параметров wallet_id, purse, amount и API ключа, например
md5('F123456789'.'10.23'.'F123456710'.'JG68NC68DJC8S0DCH6')
action transfer

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'purse'=>'F123456710',
        'amount'=>10.23,
        'sign'=>md5('F123456789'.'10.23'.'F123456710'.'JG68NC68DJC8S0DCH6'),
        'action'=>'transfer',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Payment send"}

Оплата онлайн услуг

Обязательные параметры:
wallet_id Ваш номер кошелька
service_id ID услуги
account Кошелек для перевода
amount Сумма перевода
sign Контрольная подпись MD5, формируется из параметров wallet_id, amount, account и API ключа, например
md5('F123456789'.'10.23'.'79261233212'.'JG68NC68DJC8S0DCH6')
action online_payment

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'service_id'=>3,
        'account'=>'79261233212',
        'amount'=>10.23,
        'sign'=>md5('F123456789'.'10.23'.'79261233212'.'JG68NC68DJC8S0DCH6'),
        'action'=>'online_payment',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Payment send","data":{"payment_id":"543273"}}

Список сервисов для онлайн оплаты

Обязательные параметры:
wallet_id Ваш номер кошелька
sign Контрольная подпись MD5, формируется из параметров wallet_id и API ключа, например
md5('F123456789'.'JG68NC68DJC8S0DCH6')
action providers

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'sign'=>md5('F123456789'.'JG68NC68DJC8S0DCH6'),
        'action'=>'providers',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    
    {
    "status": "info",
    "desc": "Providers list",
    "data": [
            {
                "id": "1",
                "name": "МТС",
                "min_amount": "5.00",
                "commission": "0"
            },
            {
                "id": "2",
                "name": "Билайн",
                "min_amount": "5.00",
                "commission": "0"
            },
        ]
    }

    

Проверка статуса онлайн платежа

Обязательные параметры:
wallet_id Ваш номер кошелька
payment_id Номер платежа, полученный при отправке
sign Контрольная подпись MD5, формируется из параметров wallet_id, payment_id и API ключа, например
md5('F123456789'.'6532323'.'JG68NC68DJC8S0DCH6')
action check_online_payment

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'sign'=>md5('F123456789'.'6532323'.'JG68NC68DJC8S0DCH6'),
        'action'=>'check_online_payment',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Order status","data":{"payment_id":"6532323","status":"Canceled"}}

Список Статусов

New Новая
In process В процессе
Completed Выполнена
Canceled Отменена

Создание BTC адреса

Обязательные параметры:
wallet_id Ваш номер кошелька
sign Контрольная подпись MD5, формируется из параметров wallet_id и API ключа, например
md5('F123456789'.'JG68NC68DJC8S0DCH6')
action create_btc_address

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'sign'=>md5('F123456789'.'JG68NC68DJC8S0DCH6'),
        'action'=>'create_btc_address',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"Address created","data": [{"address": "4eftk98j9h76g5454er5ty8uh3dwec"}]}

Получение BTC адреса

Обязательные параметры:
wallet_id Ваш номер кошелька
sign Контрольная подпись MD5, формируется из параметров wallet_id и API ключа, например
md5('F123456789'.'JG68NC68DJC8S0DCH6')
action get_btc_address

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'sign'=>md5('F123456789'.'JG68NC68DJC8S0DCH6'),
        'action'=>'get_btc_address',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    {"status":"info","desc":"","data": [{"address": "4eftk98j9h76g5454er5ty8uh3dwec"}]}

Уведомление о новой Bitcoin транзакции

Для получения уведомлений, укажите в настройках API свой URL для уведомлений

На данный урл, при появлении новой транзакции, будут отправлены следующие данные
wallet_id Ваш номер кошелька
address Адрес
transaction_id ID транзакции
amount Сумма
fee Комиссия
confirmations Количество подтверждений
date Дата
sign Контрольная подпись MD5, формируется из параметров wallet_id, address, transaction_id, amount, fee, confirmations, date и API ключа, например
md5('F123456789'.'567897688tgydscsd8985'.'gb56yu3txdy237dy2xu8d2983tdxy23dux2873d7yx20d'.'0.001'.'0'.'0'.'2017-01-01 23:32:33'.'JG68NC68DJC8S0DCH6')

Получение информации по Bitcoin транзакции

Обязательные параметры:
wallet_id Ваш номер кошелька
transaction_id ID транзакции
sign Контрольная подпись MD5, формируется из параметров wallet_id, transaction_id и API ключа, например
md5('F123456789'.'gb56yu3txdy237dy2xu8d2983tdxy23dux2873d7yx20d'.'JG68NC68DJC8S0DCH6')
action get_btc_transaction

Пример запроса:
    $data = array(
        'wallet_id'=>'F123456789',
        'sign'=>md5('F123456789'.'gb56yu3txdy237dy2xu8d2983tdxy23dux2873d7yx20d'.'JG68NC68DJC8S0DCH6'),
        'action'=>'get_btc_address',
    );
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://www.fkwallet.ru/api_v1.php');
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $result = trim(curl_exec($ch));
    $c_errors = curl_error($ch);
    curl_close($ch);
                

Пример ответа:
    
    {
    "status":"info",
    "desc":"",
    "data": [
        {
            "address": "4eftk98j9h76g5454er5ty8uh3dwec",
            "transaction_id": "gb56yu3txdy237dy2xu8d2983tdxy23dux2873d7yx20d",
            "amount": "0.001",
            "fee": "0",
            "confirmations": "4",
            "date": "2017-01-01 23:32:33"
        }
    ]
    }