Автоплатежи — Qiwi
QIWI — позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте.
● Адрес платёжной системы: https://qiwi.com
● Идентификация: Комментарий (Usercode или ID).
● Валюты: USD, RUB, UZS (это все существующие в системе валюты)
● Авто вывод средств: Доступен — предоставляется НЕ ВСЕМ.
�� Оплата ежемесячно (актуальную стоимость смотри при заказе подключения).
�� Заказ подключения: @MegaHubSupportBot (�� Активировать «Авто Платежи» в Боте)
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того что вы уже обладаете базовыми знаниями о том как работать с конструктором и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять значит вы слишком рано перешли к созданию функционала автоплатежей.
❖ Автоплатежи
Как организовать автоматический приём платежей QIWI в вашем боте.
Необходимые функции
Функционал раздела «��Расширения»: для показа Usercode вам нужны макросы.
Макросы Пользователя
Для подключения перейдите в вашем боте:
☞ ��Админ | ��Расширения | ��Макросы
Функционал раздела «��Расширения»: если для начисления вы не используете переменную balance , то вам понадобятся дополнительные переменные.
Доп. Переменные
Для подключения перейдите в вашем боте:
☞ ��Админ | ��Расширения | ��Переменные
Что необходимо подготовить для подключения
При подключении вы должны будете заполнить форму и предоставить все необходимые для работы Автоплатежей данные.
Какую информацию необходимо будет прислать нам для подключения:
1. Адрес бота
Бот, в котором подключаем. Просто пришлите нам @ адрес.
2. Телефон Qiwi
Номер вашего телефона Qiwi для проверки пополнений (формат: +xxxxxxxxxxx).
3. Имя переменной(ных).
Куда начислять средства от авто пополнений.
● Если у вас в боте только одна валюта, то обычно используют » balance «.
● Если несколько валют, то может быть индивидуальная переменная для каждой валюты.
Доступные валюты на данный момент:
USD, RUB, UZS
В одном сообщении укажите все необходимые переменные с соответствующей аббревиатурой валюты.
Если у вас нету переменных — вам нужно их ДОБАВИТЬ в бот и СОЗДАТЬ — ссылку на руководство мы дали выше.
Количество имеющихся у вас в боте переменных должно соответствовать количеству валют которые вы планируете принимать на разные балансы в боте.
В этом сообщении можно указать всё необходимое из списка Дополнительных Возможностей Автоплатежей.
Пример сообщения:
balance_usd — USD
balance_rub — RUB
UZS — конвертация в USD
ЕЩЕ РАЗ: переменные которые вы укажите в этом сообщении ОБЯЗАНЫ СУЩЕСТВОВАТЬ В ВАШЕМ БОТЕ — вы не можете просто взять имена переменных «с потолка» или скопировать их имена отсюда и полагать что всё будет работать только потому что вы отправили их в сообщении. Мы не думали что такие очевидные вещи нужно объяснять, но оказывается не все это понимают.
4. Токен Qiwi
Для создания токена проходим
https://developer.qiwi.com/ru/qiwi-wallet-personal/#auth_param
И читаем официальные инструкции Qiwi по созданию токена.
ВНИМАНИЕ: Для безопасности вашего кошелька, задайте данному токену ТОЛЬКО три разрешения:
● Запрос баланса
● Просмотр истории
● Запрос статуса кошелька
Подчёркиваем — никаких других разрешений у токена быть НЕ ДОЛЖНО.
В этом случае MenuBuilder сможет только запрашивать баланс кошелька, просматривать историю платежей и больше ничего. Сохранность ваших средств это ответственность Qiwi и лично ваша. MenuBuilder за сохранность ваших денег ответственности не несёт и отношения к безопасности НЕ ИМЕЕТ. Он может только просматривать содержимое.
5. Оплата: минимум за месяц
Обменяйте необходимую сумму в TMH на вашем аккаунте в @MenuBuilderBot исходя из количества месяцев подключения (актуальную стоимость смотри при заказе подключения).
☞ ��Админ | ��Расширения | ��Ваши Кошельки
Когда все необходимые данные подготовлены вы можете перейти к заказу подключения:
�� Заказ подключения: @MegaHubSupportBot (�� Активировать «Авто Платежи» в Боте)
Заполните форму заказа, отправьте данные и ожидайте ответа админов.
Как организовать Автоплатежи Qiwi в меню вашего бота
Как организовать автоплатеж через Qiwi.
Если вы уже активировали автоматическую оплату QIWI в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Практически всё что вам нужно в боте, это одна кнопка с сообщением. Кнопку назовите как хотите, например «Пополнить Баланс», а в сообщении представьте юзеру нижеследующие данные.
1. Сообщите пользователям телефонный номер вашего Qiwi. На этот номер они должны будут сделать перевод.
Принимать платежи можно и по «Никнейму» (по умолчанию: USPxxx) — укажите его в сообщении вместо номера телефона. На обработку автоплатежей это не влияет.
Для удобства ваших пользователей можно предоставить им ссылку на оплату. В этом случае для попадания в форму оплаты им просто нужно будет перейти по ссылке. Ссылка позволяет автоматически добавить к платежу нужный комментарий.
● Пример ссылки для оплаты в RUB по номеру телефона с комментарием:
https://qiwi.com/payment/form/99?currency=RUB&extra[‘account’]=+ВАШНОМЕРТЕЛЕФОНА&extra[‘comment’]=%usercode%
Вместо «ВАШНОМЕРТЕЛЕФОНА» подставьте номер телефона который указали при регистрации.
● Пример ссылки для оплаты в RUB по номеру телефона с комментарием и заблокированными полями:
https://qiwi.com/payment/form/99?currency=RUB&extra[‘account’]=+ВАШНОМЕРТЕЛЕФОНА&extra[‘comment’]=%usercode%&blocked[0]=account&blocked[1]=comment
Вместо «ВАШНОМЕРТЕЛЕФОНА» подставьте номер телефона который указали при регистрации.
● Пример ссылки для оплаты в RUB по Никнейму:
https://qiwi.com/payment/form/99999?extra[‘accountType’]=nickname&extra[‘account’]=ВАШНИКНЕЙМ&extra[‘comment’]=%usercode%
Вместо «ВАШНИКНЕЙМ» подставьте никнейм вашего аккаунта Qiwi.
При оплате по Никнейму комментарий в форму не подставляется. Причины неизвестны.
● Пример ссылки для оплаты в RUB по Никнейму с заблокированными полями:
https://qiwi.com/payment/form/99999?extra[‘accountType’]=nickname&extra[‘account’]=ВАШНИКНЕЙМ&extra[‘comment’]=%usercode%&blocked[0]=account&blocked[1]=comment
Вместо «ВАШНИКНЕЙМ» подставьте никнейм вашего аккаунта Qiwi.
При оплате по Никнейму комментарий в форму не подставляется. Причины неизвестны.
Не все способы оплаты корректно работают со ссылкой, иногда юзеры не могут ею нормально воспользоваться. Поэтому рекомендуем в этом сообщении кроме ссылки оставить и обычные реквизиты для ручной оплаты (Телефон либо Никнейм).
2. Покажите вашим пользователям их индивидуальный идентификационный код UserCode в вашем боте. Используйте в сообщении макрос %usercode% .
Если макросы UserCode не работают, значит, вам необходимо активировать его. Для этого зайдите в своего бота:
Макросы Пользователя
��Админ | ��Расширения | ��Макросы
3. Объясните пользователям, что они должны произвести платеж на ваш кошелек Qiwi, и ввести свой собственный UserCode в комментарии, чтобы их платеж можно было идентифицировать автоматически.
ВАЖНО: в комментарии НЕ ДОЛЖНО быть ничего другого, кроме самого кода пользователя.
Никаких приписок типа: «Мой код», «Пополните» и тому подобного.
Пример сообщения:
«Для пополнения сделайте перевод на наш кошелек: +xxxxxxxxxxx
В комментарии введите ваш UserCode: %usercode%
В комментарии не должно быть ничего кроме кода!«
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована автооплата Payeer.
Для этого перейдите в свой бот:
��Админ | ��Расширения | ��Ваши кошельки | ��Пополнить
❖ Дополнительная информация
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.
Автоматический вывод средств
Для платёжной системы Qiwi доступен функционал автоматического вывода средств.
Функционал полностью автоматического вывода средств предоставляется НЕ ВСЕМ.
ВАЖНО: Не пытайтесь договариваться о подключении автоматических выводов до тех пор пока полностью не разберётесь с тем как работает кнопка Выводов в полуавтоматическом режиме.
Если вы полностью разобрались с тем как работает кнопка вывода можете обратиться в бот для попытки подключить автовыводы.
�� Узнать о возможности подключения функции автовывода средств: @MenuBuilderSupportBot
Как выставить счет в QIWI Кошельке
Ещё одна интересная возможность платёжной системы Киви – выставлениие счетов на оплату. Опция будет полезна самозанятым и всем, кто не желает открывать с банковский счёт на юридическое лицо. Выставить счёт в Киви — это значит создать запрос на то, что стороннее лицо добровольно переведёт на кошелёк определённую сумму. При этом не следует путать номер счёта и номер самого кошелька.
Как происходит работа со счетами в QIWI Кошельке
Если номер QIWI кошелька постоянен и соответствует номеру мобильного телефона пользователя, то каждый выставляемый счёт имеет свой индивидуальный номер, генерируемый системой. На главной странице личного кабинета кошелька нужно выбрать пункт оплатить. При нажатии открываются две вкладки: одна «Избранные платежи», а другая «Счета», нужно войти именно в эту. В папке находится список всех выставленных счетов с разделением на те, что требуют оплаты, уже оплаченные и отклонённые.
Как выставить новый счёт в Киви кошельке
Каждый пользователь QIWI Кошелька может создать счёт на оплату, заполнить его вручную, и добавить комментарий, по которому будет видно, за что именно получен счёт. Вместо имени и номера кошелька отображается название сайта.
- Работа со счетами Киви начинается со страницы https://p2p.qiwi.com/, здесь собраны все решения для бизнеса.
- Авторизуйтесь на сайте https://p2p.qiwi.com (логин и пароль как в кошельке)
- После авторизации вы окажетесь на вкладке «Выставить счет»
- Настроить внешний вид формы можно на вкладке «Форма приема переводов»
- После заполнения указанной формы автоматически генерируется ссылка, которую остаётся только переслать клиенту.
Этот способ удобен, и позволяет:
- создавать уникальные счета, оплатить которые можно только один раз, это хорошая защита от мошенников;
- не указывать в форме запроса собственный телефонный номер, вместо него будет указываться название сайта. Клиент не сможет менять данные, указанные в счёте;
- можно выбрать способ оплаты: использовать либо кошелёк, либо карту.
Форму для выставления счета можно персонализировать: изменять цвета, конфигурацию кнопок и добавлять описание.
Форму для приёма переводов можно оформлять в виде ссылки на персональную страницу, и использовать ей в блогах, чатах и социальных сетях.
Внешний вид формы можно настраивать, начиная от названия, и заканчивая выбором градиента цвета. Если указать варианты сумм — это поможет покупателю быстрее сориентироваться, и выбрать нужную сумму в один клик.
Оплаченные счета отображаются во вкладке «Отчет по счетам». Там можно посмотреть статус счета, сумму и дату перевода.
Как отменять неоплаченные счета в Киви
Через API можно не только выставлять счета, но и отменять их, проверять статус у каждой выполненной операции. Самостоятельно отменить неоплаченный счет не получится, но можно обратиться в техподдержку QIWI за помощью в удалении. Некоторые неоплаченные счета отменяются автоматически по истечению времени жизни счета.
Чтобы работать с API QIWI Кошелька потребуются ключи. Один публичный, другой секретный. Получить ключи можно в личном кабинете после регистрации p2p.qiwi.com, тогда станет возможным редактирование и удаление неоплаченных счетов.
Ещё один интересный вариант использования решений для бизнеса и работы с выставляемыми счетами, это использование виджета. Его можно встраивать в блог, или на сайт, передавать друзьям, чтобы они поместили его на своей странице.
Прием платежей на сайте через QIWI
Прием платежей на сайте можно организовать разными способами. Самый удобный – это посредники, агрегаторы платёжных сервисов. Однако, у большинства них жесткие условия и комиссии. Альтернатива – подключиться к платежным системам напрямую. В случае банков это непросто, но для электронные кошельков не составляет проблемы. Кроме того, помимо самих кошельков, через ПС можно платить и картами российских банков. Давайте рассмотрим пример подключения приема платежей на сайте для QIWI через api.
Вообще, данное апи предназначено для получения платежей физическими лицами. Оно так и называется — API P2P-счетов. То есть если у вас небольшой ресурс, то вы смело можете настраивать прием денежки на свой кошелек. Условие одно – он должен иметь статус «Основной», то есть вы должны ввести свои реальные данные в систему киви.
Переходим сюда https://qiwi.com/p2p-admin/api и создаем пару ключей для каждого сайта. Галочку для уведомлений на первое время можно не ставить
Получаем два ключа. Один публичный и второй приватный. Скопируйте и сохраните их.
Код фронтенд
Код условный, все в целом так будет работать, но у вас наверняка будут некоторые изменения, я же дам больше общую концепцию, как я обычно использую в работе.
Итак, первое – это некая форма, в которой пользователь будет вводить сумму, на которую хочет пополнить свой (ваш) баланс
Здесь кнопка и два параметра – ид аккаунта (чтобы мы знали, кому пополнять баланс на сайте) и собственно сумма пополнения, по умолчанию стоит 1 рубль.
По нажатию кнопки будет выполняться вот такой JS код (я использую jQuery но вам никто не мешает использовать что-то свое)
- ajax.php – адрес файла обработчика
- QIWI_PUBLIC_KEY – публичный ключ, который вы получали ранее
Как выглядит
Вот такое открывается у нас новое окно
Теперь давайте приведу примерный код файла ajax.php
А теперь нам надо проверять оплаченные счета. Вообще, сам киви рекомендует делать это через вебхуки. Однако проще проверять их самостоятельно периодически. Например, запустить на выполнение через крон скрипт примерно такого содержания
Сама функция получения статуса счета
Для простоты и наглядности обработка ошибок везде пропущена, вам необходимо будет добавить её самостоятельно.
Вот так несложно и быстро можно подключить к своему сайту прием платежей, оплату чего-либо. Если вам требуется платная помощь или консультация – пишите мне.
Автор этого материала — я — Пахолков Юрий. Я оказываю услуги по написанию программ на языках Java, C++, C# (а также консультирую по ним) и созданию сайтов. Работаю с сайтами на CMS OpenCart, WordPress, ModX и самописными. Кроме этого, работаю напрямую с JavaScript, PHP, CSS, HTML — то есть могу доработать ваш сайт или помочь с веб-программированием. Пишите сюда.
заметки, qiwi, php, javascript
Гайд [Node.JS] Делаем простую автооплату через QIWI (VK Bot)
Привет ✋, давно хотел написать подобный гайд и вот дошли руки. Напишем с вами простого бота в VK с автооплатой через QIWI.
Что нам понадобится для работы:
1) Любая библиотека для работы с API VK (я буду использовать EasyVK)
2) Node-QIWI-SDK
3) Сам Node.JS
После установки всего, что я описал выше переходим в ВКонтакте и создаем или используем уже существующую группу:
1) Переходим в раздел "Работа с API"
В данном разделе переходим в LongPoll API и включаем LongPoll, версию API выбираем 5.103 (можете и свою, я всегда использую 5.103)
Переходим в "Типы событий" и включаем событие на "Входящие сообщения", этого нам хватит.
2) Переходим в раздел "Сообщения" и включаем сообщения группы.
Группа готова к использованию, перейдем к написанию кода, создаем JS файл и открываем его в любом редакторе.
