slmatthew/vk-coin

VK Coin API

dev-master 2019-04-15 14:57 UTC

Requires

• php: >=5.5.5

MIT

• vk
• coin

README

Написал что-то типа фреймворка для работы с VK Coin API. Надеюсь, что ошибок не будет.

Формат ответа

При вызове функции getTransactions() или sendTransfer() возвращается массив с двумя полями, либо false.

Имя поля	Тип	Описание
status	bool	true, если запрос успешен. false, если произошла ошибка
response	array	Возвращается только если status == true. Массив, содержащий ответ API.
error	string	Возвращается только если status == false. Строка, описывающая ошибку CURL.

Если что-то пошло не так, вернётся значение false. Проверить можно так:

$result = $vkcoin->getTransactions();
if($result === false) {
	// что-то пошло не так
} elseif($result['status']) {
	// запрос выполнен успешно
} else {
	// обработка ошибки CURL
}

Важно! Ответ API можно будет получить через $result['response'], если ответ API примерно таков:

{
  "status": true,
  "response": {
    "response": {
      "1": 92696964157
    }
  }
}

Раньше нужно было писать $result['response']['response']. Чтобы понять, что я написал, лучше загляните в код, функция request().

Инициализация

Пример:

include './lib.php';

$vkcoin = new VKCoinClient(305360617, 'cNwFTVP7Y33M5TxgZMhLQmdcNrb6qu72mNCTeRdX9PVEqbJPpe');

Параметр	Тип	Обязательный?	Описание
merchant_id	int	yes	ID странички, для которой был получен платёжный ключ
apikey	string	yes	Платёжный ключ

Получение списка транзакций

Пример:

$vkcoin->getTransactions();
$vkcoin->getTransactions(2);
$vkcoin->getTransactions(1, 200);

Параметр	Тип	Обязательный?	Описание
tx_type	int	no	Описано в документации
last_tx	int	no	Номер последней транзакции

Перевод

Пример:

$vkcoin->sendTransfer(305360617, 15000);

Параметр	Тип	Обязательный?	Описание
to_id	int	yes	ID пользователя, которому будет отправлен перевод
amount	int	yes	Сумма перевода в тысячных долях (если указать 15, то будет отправлено 0,015 коина)

Получение баланса

Пример:

$vkcoin->getBalance(array(2050, 54986442));
$vkcoin->getBalance([1, 2]);

Параметр	Тип	Обязательный?	Описание
user_ids	array	yes	Описано в документации

Получение ссылки на оплату

Пример:

$vkcoin->generatePayLink(15000);
$vkcoin->generatePayLink(15000, 123456);
$vkcoin->generatePayLink(15000, 0, false);

Параметр	Тип	Обязательный?	Описание
sum	int	yes	Сумма перевода
payload	int	no	полезная нагрузка, любое число от -2000000000 до 2000000000. Если равно нулю, то будет сгенерировано рандомное число
fixed_sum	bool	no	Сумма фиксирована или нет? Документация
use_hex_link	bool	no	Генерация ссылки с hex-значениями или нет