{"id":15134270,"url":"https://github.com/trofimovdev/vkcoinapi","last_synced_at":"2026-02-06T23:33:29.933Z","repository":{"id":57477510,"uuid":"181587355","full_name":"trofimovdev/vkcoinapi","owner":"trofimovdev","description":"Обертка над VK Coin API","archived":false,"fork":false,"pushed_at":"2019-04-20T13:47:40.000Z","size":29,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-24T13:58:07.036Z","etag":null,"topics":["api","coin","vk","vk-api","vkapi","vkcoin"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trofimovdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-16T00:49:45.000Z","updated_at":"2023-12-14T12:19:17.000Z","dependencies_parsed_at":"2022-08-30T18:10:08.257Z","dependency_job_id":null,"html_url":"https://github.com/trofimovdev/vkcoinapi","commit_stats":null,"previous_names":["bixnel/vkcoinapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/trofimovdev/vkcoinapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trofimovdev%2Fvkcoinapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trofimovdev%2Fvkcoinapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trofimovdev%2Fvkcoinapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trofimovdev%2Fvkcoinapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trofimovdev","download_url":"https://codeload.github.com/trofimovdev/vkcoinapi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trofimovdev%2Fvkcoinapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29180441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T23:15:33.022Z","status":"ssl_error","status_checked_at":"2026-02-06T23:15:09.128Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","coin","vk","vk-api","vkapi","vkcoin"],"created_at":"2024-09-26T05:04:10.410Z","updated_at":"2026-02-06T23:33:29.917Z","avatar_url":"https://github.com/trofimovdev.png","language":"Python","readme":"# vkcoinapi\nОбертка над VK Coin API на Python\n# Установка\n```python\npip3 install vkcoinapi\n```\n# Использование\nПеред началом необходимо создать экземпляр класса **VKCoin**.\nОн принимает 2 аргумента:\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|key|\u003cp align=\"center\"\u003estr\u003c/p\u003e|\u003cp align=\"center\"\u003e+\u003c/p\u003e|Ключ доступа к VK Coin, полученный здесь: [vk.com/coin#create_merchant](https://vk.com/coin#create_merchant)|\n|merchantId|\u003cp align=\"center\"\u003eint\u003c/p\u003e|\u003cp align=\"center\"\u003e+\u003c/p\u003e|ID пользователя ВКонтакте, для которого получен ключ|\n|token|\u003cp align=\"center\"\u003estr\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|Токен, полученный из URL адреса [здесь](https://oauth.vk.com/authorize?client_id=6334949\u0026scope=1073737727\u0026redirect_uri=https://api.vk.com/blank.html\u0026display=page\u0026response_type=token\u0026revoke=1). Необходим только при использовании longPoll() и getTop().|\n```python\nfrom vkcoinapi import *\ncoin = VKCoin(key = 'ваш_ключ', merchantId = ваш_id)\n```\nПосле этого становятся доступны следующие методы, которые возвращают JSON словарь:\n## getPaymentURL()\nВозвращает ссылку на перевод вида `https://vk.com/coin#xВАШID_СУММА_PAYLOAD`.\\\nЕсли необходимо, чтобы пользователь мог изменить сумму перевода, то в конец добавляется `_1`.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|amount|\u003cp align=\"center\"\u003eint\u003c/p\u003e|\u003cp align=\"center\"\u003e+\u003c/p\u003e|Сумма перевода.|\n|payload|\u003cp align=\"center\"\u003eint\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|Любое число от `-2000000000` до `2000000000`, вернется вам в списке транзаций. Если не указано, отправляется случайное число.|\n|free|\u003cp align=\"center\"\u003ebool\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|Может ли пользователь изменять сумму перевода. По умолчанию `False`.\n```python\ncoin.getPaymentURL(1000)\n\u003e\u003e\u003e 'https://vk.com/coin#xВАШID_1000_PAYLOAD'\n```\n**Обратите внимание, что сумма указывается в тысячных долях.**\\\nВ примере выше 1000 = 1 VK Coin.\nТ.е., для того, чтобы отправить 0,001 VK Coin, нужно указать `1`.\n\n\n## getTransactions()\nВозвращает список транзакций.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|type|\u003cp align=\"center\"\u003eint\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|1 — вернутся 1000 последних транзакций **со ссылки на оплату**\u003cbr\u003e2 — вернутся 100 последних транзакций\u003cbr\u003eПо умолчанию `2`.|\n```python\ncoin.getTransactions()\n\u003e\u003e\u003e {'response': [\n                  {'id': 1370037,\n                   'from_id': 1,\n                   'to_id': 2,\n                   'amount': '100',\n                   'type': 3,\n                   'payload': 1,\n                   'external_id': 0,\n                   'created_at': 1555369262},\n                  {'id': 1369973,\n                   'from_id': 2,\n                   'to_id': 1,\n                   'amount': '100',\n                   'type': 3,\n                   'payload': 1,\n                   'external_id': 0,\n                   'created_at': 1555369272}\n                  ]}\n```\n\n## sendPayment()\nОтправляет перевод.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|to|\u003cp align=\"center\"\u003eint\u003c/p\u003e|\u003cp align=\"center\"\u003e+\u003c/p\u003e|ID пользователя, кому отправляем перевод.|\n|amount|\u003cp align=\"center\"\u003eint\u003c/p\u003e|\u003cp align=\"center\"\u003e+\u003c/p\u003e|Сумма перевода.|\n```python\ncoin.sendPayment(1, 100)\n\u003e\u003e\u003e {'response': {'id': 1400290, 'amount': 100, 'current': 578637358}}\n```\n\n## getBalance()\nПозволяет получить баланс пользователей.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|user_ids|\u003cp align=\"center\"\u003elist\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|ID пользователей, для которых нужно узнать баланс.\u003cbr\u003eПо умолчанию — наш ID.|\n```python\ncoin.getBalance()\n\u003e\u003e\u003e {'response': {'165275777': 578637358}}\n\ncoin.getBalance([1, 1324639])\n\u003e\u003e\u003e {'response': {'1': 92697214157, '1324639': 6935662916530}}\n```\n\n## getTop()\nВозвращает список текущего топа.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|type|\u003cp align=\"center\"\u003estr\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|Тип возвращаемого топа (`group` или `user`).\u003cbr\u003eПо умолчанию — `group`.|\n\n```python\ncoin.getTop()\n\u003e\u003e\u003e [\n     {'id': 67580761,\n      'score': 473553513081870,\n      'name': 'КБ',\n      'screen_name': 'countryballs_re',\n      'is_closed': 0,\n      'type': 'page',\n      'photo_200': 'https://sun9-18.userapi.com/c850420/v850420990/ff275/6svrAL6jtME.jpg?ava=1',\n      'link': 'https://vk.com/club67580761'},\n     {'id': 98699940,\n     'score': 473550301524363,\n     'name': \"Bratishkin's Stream\",\n     'screen_name': 'bratishkinoff',\n     'is_closed': 0,\n     'type': 'page',\n     'photo_200': 'https://sun9-9.userapi.com/c851416/v851416466/fcfa5/LZGnlIJVEBw.jpg?ava=1',\n     'link': 'https://vk.com/club98699940'}\n    ]\n```\n\n## longPoll()\nБлокирующий «longpoll». Не принимает аргументов.\u003cbr\u003e\nПри появлении новой входящей транзакции возвращает следующий словарь:\n\n|Ключ|Тип|Описание|\n|-|-|-|\n|from|\u003cp align=\"center\"\u003estr\u003c/p\u003e|ID пользователя, от которого пришел платеж.|\n|amount|\u003cp align=\"center\"\u003eint\u003c/p\u003e|Сумма платежа.|\n|payload|\u003cp align=\"center\"\u003eint\u003c/p\u003e|Payload для нахождения платежа в истории.|\n\n\n\n```python\ncoin.longPoll()\n\u003e\u003e\u003e {'response': {'from': 165275777, 'amount': 1, 'payload': 1624215}}\n```\n\n## setShopName()\nИзменяет название магазина.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|name|\u003cp align=\"center\"\u003estr\u003c/p\u003e|\u003cp align=\"center\"\u003e+\u003c/p\u003e|Новое название магазина.|\n\n```python\ncoin.setShopName('My Shop')\n\u003e\u003e\u003e {'response': '1'}\n```\n\n## setCallback()\nИзменяет адрес для callback запросов.\n\n\n|Аргумент|Тип|Обязательный|Описание|\n|-|-|-|-|\n|callback|\u003cp align=\"center\"\u003estr\u003c/p\u003e|\u003cp align=\"center\"\u003e—\u003c/p\u003e|Адрес для callback запросов.\u003cbr\u003eЕсли не передан, callback выключается (передается `none`).|\n\n```python\ncoin.setCallback('https://example.com/callback')\n\u003e\u003e\u003e {'response': 'ON'}\n\ncoin.setCallback()\n\u003e\u003e\u003e {'response': 'OFF'}\n```\n\n# Ссылки\n* Я ВКонтакте: [vk.com/bixnel](https://vk.com/bixnel)\n* Подробнее про VK Coin API: [vk.com/@hs-marchant-api](https://vk.com/@hs-marchant-api)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrofimovdev%2Fvkcoinapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrofimovdev%2Fvkcoinapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrofimovdev%2Fvkcoinapi/lists"}