PHPackages                             nazbav/vk-coin-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. nazbav/vk-coin-api

AbandonedArchivedLibrary

nazbav/vk-coin-api
==================

Library for VK Coin API.

2.0.0(7y ago)0211MITPHPPHP >=5.4

Since Apr 18Pushed 6y agoCompare

[ Source](https://github.com/nazbav/vk-coin-api)[ Packagist](https://packagist.org/packages/nazbav/vk-coin-api)[ RSS](/packages/nazbav-vk-coin-api/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (4)DependenciesVersions (4)Used By (0)

VK Coin API
===========

[](#vk-coin-api)

Задать вопрос можно в [беседе](https://vk.me/join/AJQ1d6PnhgV0xKfFdpK3ChdC). Библиотека для работы с VK Coin API. Основана на "[документации](https://vk.com/@hs-marchant-api)".

[![](https://camo.githubusercontent.com/3a978810541933a1c44c3bf19e17644be51dd2cff6dbe3ff3ae8618ed9f3044d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e617a6261762f766b2d636f696e2d6170693f636f6c6f723d464636463631267374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/3a978810541933a1c44c3bf19e17644be51dd2cff6dbe3ff3ae8618ed9f3044d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e617a6261762f766b2d636f696e2d6170693f636f6c6f723d464636463631267374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/c5134a81cbd865d7395d9a96a6975c20537d2331ab17237f42d117a2975ac48d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6e617a6261762f766b2d636f696e2d6170692e7376673f636f6c6f723d677265656e267374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/c5134a81cbd865d7395d9a96a6975c20537d2331ab17237f42d117a2975ac48d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6e617a6261762f766b2d636f696e2d6170692e7376673f636f6c6f723d677265656e267374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/53539be282e85de81ca6a3e3bf17292a096c80e6d5d066f42662abc46674cb67/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6e617a6261762f766b2d636f696e2d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/53539be282e85de81ca6a3e3bf17292a096c80e6d5d066f42662abc46674cb67/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6e617a6261762f766b2d636f696e2d6170692e7376673f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/c334c3b87b68aa59bb83c4eb175bf52cf9457023d432b713d418b396ae6bc8b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7265706f2d73697a652f6e617a6261762f766b2d636f696e2d6170692e7376673f636f6c6f723d677265656e267374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/c334c3b87b68aa59bb83c4eb175bf52cf9457023d432b713d418b396ae6bc8b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7265706f2d73697a652f6e617a6261762f766b2d636f696e2d6170692e7376673f636f6c6f723d677265656e267374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/218f9086e690d83106cf2368860c26f91f33366a707c647bf5610b4c179e3652/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6d6d69742d61637469766974792f6d2f6e617a6261762f766b2d636f696e2d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/218f9086e690d83106cf2368860c26f91f33366a707c647bf5610b4c179e3652/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6d6d69742d61637469766974792f6d2f6e617a6261762f766b2d636f696e2d6170692e7376673f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/93882e958c09bb7a0ac03673090d2b90c0bbcd6b85f85a7750667104758554f6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e617a6261762f766b2d636f696e2d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/nazbav/vk-coin-api/)[![](https://camo.githubusercontent.com/32ba8f2313425110f345a7a084032c0fbe933a1c1425cc7b7c319c7c6c966900/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e617a6261762f766b2d636f696e2d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/nazbav/vk-coin-api/issues)

Подключение
-----------

[](#подключение)

```
composer require nazbav/vk-coin-api
```

1. Через Composer:

```
include "../vendor/autoload.php";

$coin = new \nazbav\VkCoinAPI\VkCoin(211984675, "45vyv45KJMKouj9retghrebtvrhtrehryvt54ONopiino");
```

1. С обработкой исключений:

```
include "../vendor/autoload.php";

try {
    $coin = new \nazbav\VkCoinAPI\VkCoin(211984675, "45vyv45KJMKouj9retghrebtvrhtrehryvt54ONopiino");
//ваш код...
} catch (VkCoinException $e) {
    echo $e;
}
```

ПараметрТипОписание$merchantIdintID странички, для которой был получен платёжный ключ$keystringПлатёжный ключ$checkResponsestringОтлов ошибок, по умолчанию `true`(см. `Получение ошибок` ниже).Функции
-------

[](#функции)

#### CallBack | Транзакции

[](#callback--транзакции)

Установка callBack.

```
    $coin->callBack('https://example.org/callback');
```

Удаление callBack.

```
    $coin->callBack();
```

ПараметрТипОписаниеurlstringАдрес для отправки уведомленийВалидация запроса:

```
$request = json_decode(file_get_contents('php://input'), true);

// Проверка наличия полей: id, from_id, amount, payload, key
if (!empty($request) &&
    //...
    isset($request['key'])
) {

    if ($coin->getFunc()->validationKey(
        $request['id'],
        $request['from_id'],
        $request['amount'],
        $request['payload'],
        $request['key']
    )) {
//Код...
    }
}
```

ПараметрТипОписаниеidintномер транзакцииfrom\_idintот когоamountintКоличествоpayloadintЧисло от -2000000000 до 2000000000.keystringКлючПолучение списка неудавшихся запросов

```
    $coin->logs();
```

ПараметрТипОписаниеstatusintПолучение логов#### Настройка магазина

[](#настройка-магазина)

Установка названия магазина

```
    $coin->setName('CoinShop');
```

ПараметрТипОписаниеnamestringНазвание магазина#### Получение списка транзакций

[](#получение-списка-транзакций)

Пример:

```
    $coin->tx(); //type 1 -- получение транзакций по ссылке
    $coin->tx(2, -1); // получение транзакций магазина (первые 100)
```

ПараметрТипtypeintlastint#### Перевод

[](#перевод)

Пример:

```
$coin->send(211984675, $coin->toCoin(1));//Отправка одного коина
$coin->send(211984675, 1, false, true);//отправка 1% баланса магазина
$coin->send(211984675, 1, true);//отправка 1 коина
```

ПараметрТипОписаниеtointID пользователя, которому будет отправлен переводamountintСумма перевода в тысячных долях (500 = 0,500 коин)fromFloatboolamount задан в float (см. функции библиотеки ниже)?fromPercentboolamount задан в процентах?#### Получение баланса

[](#получение-баланса)

Пример:

```
$coin->score([211984675]);
$coin->score(); //Для вывода баланса текущего пользователя
```

ПараметрТипuserIdsarray#### Получение ссылки на оплату

[](#получение-ссылки-на-оплату)

Пример:

```
   $coin->getFunc()->link(); // vk.com/coin#tMERCHANTID - сылка для **обычной** оплаты!
   $coin->getFunc()->link(15000);//sum
   $coin->getFunc()->link(15000, 123456); //sum, payload
   $coin->getFunc()->link(15000, 0, false); //sum, payload, fixed_sum = false
      $coin->getFunc()->link(15000, 0, false, false); //sum, payload, fixed_sum = false, hex = false
```

ПараметрТипОписаниеsumintСумма переводаpayloadintЛюбое число от -2000000000 до 2000000000. Поставь 0, дальше сделаем все сами ;)fixed\_sumboolФиксация суммы переводаhexboolГенерация hex-ссылки#### Псевдонимы (Aliases)

[](#псевдонимы-aliases)

Их вы можете указывать в параметре метода, для упращения работы.

ИмяПсевдонимОписаниеsetconfigПараметры магазинаsetsettingsПараметры магазинаtxgetTransactionsСписок транзакцийtxtransactionsСписок транзакцийlinkgetPayLinkПлатежная ссылккаlinkgetLinkПлатежная ссылккаsendtransferОтправка переводаsendsendTransferОтправка переводаsendpayОтправка переводаaliasgetAliasesСписок псевдонимовaliasaliasesСписок псевдонимовscoregetBalanceБаланс игрокаscorebalanceБаланс игрока#### Формат ответа

[](#формат-ответа)

Имя поляТипОписаниеstatusbool`true`, если запрос выполнен без критических ошибок.responsearrayМассив с данными (за место него может быт выдан `error`)errorarrayДля получения этого массива см. `Получение ошибок`Данному формату не подчиняются методы начинающиеся с `$coin->getFunc()`.

#### Получение ошибок

[](#получение-ошибок)

По стандарту библиотека сама обрабатывает ошибки и выдает VkCoinException на этот счет. Для того чтобы самостоятельно обрабатывать ошибки необходимо передать всего один параметр при инициализации:

```
include "../vendor/autoload.php";

$coin = new \nazbav\VkCoinAPI\VkCoin(211984675, "45vyv45KJMKouj9retghrebtvrhtrehryvt54ONopiino", true);
```

#### Error code 100

[](#error-code-100)

В случай если библиотеке не удалось получить данные c сервера, и т.д. (ошибки curl). Будет выдана 100 ошибка:

```
{"status":false,
      "error":{
        "code":100,
        "message":"Описание ошибки."
      }
}
```

#### Функции библиотеки

[](#функции-библиотеки)

**Получение Key**

```
$coin->getFunc()->getMerchkey();
```

**Получение MerchantId**

```
$coin->getFunc()->getMerchantId();
```

**Перевод числа с плавающей точкой в коины**

```
$coin->getFunc()->toCoin(100.000); //100000
$coin->getFunc()->toCoin(100.435); //100435
```

Пример: отправка 1 коина (1.000) пользователю:

```
$coin->send(211984675, $coin->getFunc()->toCoin(1));//1000
$coin->send(211984675, $coin->getFunc()->toCoin(1.000));//1000
```

**Перевод коинов в число с плавающей точкой**

```
$coin->getFunc()->toFloat(100000); //100.000
$coin->getFunc()->toFloat(100435); //100.435
```

Пример: запрос баланса мерча, разбор ответа, конвертация в float:

```
$coin->getFunc()->toFloat($account1); //float(124414.662)
```

**Получение процента (A) от числа (B)**

```
$coin->getFunc()->toFloat($coin->getFunc()->getPercent(75, $coin->getFunc()->toCoin(1)));//75% от 1 коина (1,000)
```

Пример: 75% от 10.000 VKC = 7.500 VKC:

```
$coin->getFunc()->toFloat($coin->getFunc()->getPersent(75, $coin->getFunc()->toCoin(10)));
```

**Процент числа A от числа B**

```
//Сколько процентов занимает 1 коин от 100 коинов
$coin->getFunc()->whatPercent($coin->getFunc()->toFloat(1),$coin->getFunc()->toFloat(100));
```

Пример: на сколько процетов баланс пользователя id1\* больше баланса пользователя id2\*:

```
$coin->getFunc()->whatPercent($account2, $account1)
```

Сколько процентов составляет баланс пользователя id2\* от баланса пользователя id1\*:

```
$coin->getFunc()->whatPercent($account1, $account2)
```

Даные в примерах:

```
 $balance = $coin->score([1*, 2*])['response'];
    $account1 = $balance[2*];
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

3

Last Release

2576d ago

Major Versions

1.3.0 → 2.0.02019-04-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/1fded4ca698f452b7f24f4f8175a46894794b0778d202676e8864b8a1aa37136?d=identicon)[nazbav](/maintainers/nazbav)

---

Tags

coincoinvk-apiphp-libraryvkvk-apivk-coinvk-coin-apivkcoinVK apiPHP LibrarycoinVKCOINVK COIN API

### Embed Badge

![Health badge](/badges/nazbav-vk-coin-api/health.svg)

```
[![Health](https://phpackages.com/badges/nazbav-vk-coin-api/health.svg)](https://phpackages.com/packages/nazbav-vk-coin-api)
```

###  Alternatives

[ccxt/ccxt

A cryptocurrency trading API with more than 100 exchanges in JavaScript / TypeScript / Python / C# / PHP / Go

41.5k328.9k1](/packages/ccxt-ccxt)[lodash-php/lodash-php

A port of Lodash to PHP

527719.0k5](/packages/lodash-php-lodash-php)[spekulatius/phpscraper

PHPScraper, built with simplicity in mind. See tests/ for more examples.

583143.5k3](/packages/spekulatius-phpscraper)[krowinski/php-mysql-replication

Pure PHP Implementation of MySQL replication protocol. This allow you to receive event like insert, update, delete with their data and raw SQL queries.

338118.0k10](/packages/krowinski-php-mysql-replication)[inhere/php-validate

generic data validate, filter library of the php

26787.4k13](/packages/inhere-php-validate)[x-fran/g-trends

Google Trends API for PHP

11955.6k](/packages/x-fran-g-trends)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)