vkcoin-callback-api

vkcoin-callback-api

Модуль для работы с методами VK Coin api

VKCOIN-CALLBACK-API

Авторизация пользователя

Для на чала работы, необходимо получить Merchant Key от аккаунта здесь После того как мы получили платежный ключ, необходимо авторезироваться

let VKCOIN = require(`vkcoin-callback-api`);
let vkcoin = new VKCOIN({
  id: 1111111111, // Ваш id
  key: "5rgpokeK[AQL,zZv6q6d!YJb_uiiOIIuhC![,#uzx4AoT#.reV21", // Ваш Merchant Key
});

Ссылка на оплату состоит из трех частей:

Ваш id (19039187)

1. Сумма перевода в тысячных долях (1000)

2. Payload – любое число от -2000000000 до 2000000000, вернется вам в списке транзаций

Далее их надо объединить в такую ссылку: vk.com/coin#x190391871000 2000000000

Это и будет ссылка на оплату для пользователя (обратите внимание, что самому себе переводы запрещены). По умолчанию пользователь не может изменить сумму перевода. Если это требуется, сделайте ссылку вида

vk.com/coin#x19039187_1000_2000000000_1 — свободная сумма

vk.com/coin#x19039187_1000_2000000000 — фиксированная сумма

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

vkcoin.getLink(amount, payload, fixed); // Первым параметром передаем количество коинов по дефолту, вторым параметром payload котовый вернет VK Coin при пополнении по ссылке (любое число от -2000000000 до 2000000000), третий параметр не обязательный (Устанавливает фиксированную сумму в поле для оплаты)

console.log(vkcoin.getLink(100500, 123456789)); // Ссылку в свободном формате с дефолтным значением 100,500 и payload 123456789  vk.com/coin#x19039187_100500_123456789

Запуск сервера

После того как мы авторизировались необходимо подписаться на входящие транзакции VK Coin.

let port = 3223;

vkcoin.startServer({
  server: "132.123.238.45", // Сервер (Обязательное поле)
  port: port, // Порт (По умолчанию 1234)
});

и запустить сервер для прослушивания новых платежей

vkcoin.startPolling(async (event) => {
  // Здесь обрабатывем транзакцию
  console.log(event);
});

Устанавливаем название магазина

vkcoin.shopName("Name");

После того как мы установили параметр названия, можно отправлять VK Coin от имени магазина.

Выполняем перевод пользователю

vkcoin.send(431035213, 5000);

Где 431035213 - ID получателя, 5000 - Количество коинов для перевода (ВНИМАНИЕ! Количество указывается в тысячных долях, тоеть 5000 = 5 VK Coin)

Для того чтобы платеж был от имени магазина, необхоимо отправить третий параметр

vkcoin.send(431035213, 5000, true);

Проверка баланса

Для проверки баланса необходимо обратится к методу getBalance и передать массив содержащий не более 100 id получателей

async function get() {
  let bal = await vkcoin.getBalance([431035213]);
  console.log(bal);
}

get();

После чего мы получим: { response: { '431035213': 10991024280 } }

Для обработки этого ответа console.log(bal.response[431035213]) в таком случае мы поучим баланс пользователя 431035213 в тысячных долях 10991024280

Получим баланс нескольких пользователей

let users = [431035213, 237435213, 237435783];

async function get() {
  let bal = await vkcoin.getBalance(users); // Получаем баланс пользователей
  // Выведем их в консоль по одному
  for (let i = 0; i < users.length; i++) {
    console.log(bal.response[users[i]] / 1000); // В таком случае мы выведем в консоль баланс всех пользователей в привычном нам формате.
  }
}

Форматирование возвращаемого значения

vkcoin.format(12345678900); // Вернет значение в привычном формате - 12 345 678,900

Пример использования совместно с vk-io

let VKCOIN = require(`vkcoin-callback-api`);
const { VK } = new require("vk-io");
const vk = new VK();

let link = vk.com/coin#x${ID}_${amount}_${payload}_1 // Собираем ссылку по которой нам будут переводить коины


vk.setOptions({
  token: "Ваш токен сообщества",
  pollingGroupId: 1111, // id паблика
  apiMode: "parallel", // execute api mode для отправки до 50 сообщний в секунду
});

let vkcoin = new VKCOIN({
  id: 1111111111, // Ваш id
  key: "5rgpokeK[AQL,zZv6q6d!YJb_uiiOIIuhC![,#uzx4AoT#.reV21", // Ваш Merchant Key
});

vkcoin.startServer({
  server: "188.323.22.11", // Сервер (Обязательное поле)
  port: 1111, // Порт (По умолчанию 1234)
});

vkcoin.shopName("VK Coin bot"); // Устанавливаем название магазина

vkcoin.startPolling(async (event) => {
  console.log(event); // Выводим в консоль то что нам вернет вк коин при переводе на нашего бота
  /*
  response возвращаемый при поплнении бота по ссылке:
  {
 id: 418034787, (id транзакции)
 fromId: 431035213, (id пользователя отправившего нам коины)
 toId: 354673884, (id нашего бота)
 amount: 5000, (Сумма пополнения * в тысячных долях, тоесть нам перевели 5 VK Coin)
 payload: -944320189, (payload перевода * указывается в ссылке на пополнение)
 created_at: 1595181763, (Дата события)
 from_id: 431035213,  (id пользователя отправившего нам коины)
 to_id: 354673884, (id нашего бота)
 key: 'dbd9579344cdc9d22e912219a3801e34' (хэш)
 }
 */

// Далее обробатываем

let balance = await vkcoin.getBalance([event.fromId]) // Проверяем баланс пользователя отправившего нам коины
if (balance[event.fromId] / 1000 < 5000000) {
  vkcoin.send(event.fromId, 5000000 - balance[event.fromId] / 1000) // Отправляем пользователю коины для того чтобы его баланс был равен 5 000 000

  vk.api.messages.send({
    user_id: event.fromId,
    message: `Мы отправили тебе ${5000000 - balance[event.fromId] / 1000}
    Теперь твой баланс 5 000 000` // Отправляем пользователю сообщение о том что его баланс пополнен
  });
} else {
vk.api.messages.send({
    user_id: event.fromId,
    message: `Твой баланс ${vkcoin.format(balance[event.fromId] / 1000)}, так как твой баланс больше 5 000 000
мы тебе ничего не отправим` // Отправляем пользователю сообщение о том что его баланс более 5 000 000 VK Coin
  });
}
});

Made by ХОР ЕНОТОВ