К содержанию

Приём криптовалюты в Paymenter

Шлюз CoinsPay позволяет клиентам оплачивать счета Paymenter в USDT, BTC, ETH или другой из 30+ монет. Платёж сам добавляется в счёт, Paymenter включает или продлевает услугу, а деньги уходят прямо на ваши кошельки.

Paymenter
1.4.0 и новее
PHP
8.2 и новее
Модуль
бесплатный, GPL 3.0

Что даёт шлюз

  • Услуги включаются сами

    Когда платёж подтверждён, шлюз добавляет его в счёт, а Paymenter делает то же, что после любой оплаты: отмечает счёт оплаченным, включает или продлевает услугу и пишет клиенту. Проверять платежи вручную не нужно.

  • Деньги сразу на ваших кошельках

    CoinsPay не держит выручку у себя: каждая оплата уходит на ваши кошельки по правилу выплат магазина. В каждой сети до 5 адресов с долями, например 70 % вам и 30 % партнёру.

  • Цены остаются в вашей валюте

    Клиент платит остаток по счёту в его валюте. CoinsPay пересчитает сумму в монету по текущему курсу и удержит её 30 минут, пока клиент открывает кошелёк. В счетах в валюте, которую CoinsPay не принимает, шлюз не показывается.

  • Ключ, которым нельзя вывести деньги

    Шлюзу хватает ключа с доступом «Только счета»: им можно выставлять счета и следить за ними, а вывести деньги нельзя. Ключ и секрет вебхука Paymenter хранит зашифрованными.

Подключение за пять минут

Нужны кабинет CoinsPay с магазином и доступ к админке Paymenter. Программист не нужен.

  1. 01Установите модульСкачайте архив и загрузите его в Extensions → Extensions → «Upload Extension». Или распакуйте его в папку Paymenter, чтобы он оказался в extensions/Gateways/CoinsPay.
  2. 02Добавьте шлюзВ Extensions → Gateways нажмите «New gateway», выберите CoinsPay и задайте название, которое увидят клиенты. В кабинете CoinsPay выпустите ключ с доступом «Только счета» и вставьте его в поле «API key».
  3. 03Подключите вебхукСкопируйте адрес вебхука из блока «Status» в настройках шлюза в раздел «Вебхук» кабинета, а ключ подписи whsec_ — обратно в шлюз.
  4. 04Сохраните и проверьтеПосле сохранения блок «Status» покажет имя вашего магазина в CoinsPay и боевой режим. Отправьте тестовое событие из кабинета, и блок его отметит. Клиенты уже видят CoinsPay в своих счетах.
Настройки шлюза CoinsPay в админке Paymenter: блок состояния с адресом вебхука, магазином в боевом режиме и тестовым событием, поля шлюза

Шлюз справляется и с неудобными случаями

Частичная оплата, изменённый или отменённый счёт, потерянный вебхук: шлюз добавляет в счёт ровно то, что пришло, и показывает, где нужно ваше решение.

  • Платёж в пути

    Пока сеть подтверждает платёж, в счёте он виден как «processing»: клиент знает, что деньги идут. Когда платёж подтверждён, счёт оплачен.

  • Недоплата

    Если пришло меньше, клиент может доплатить на той же странице оплаты. Когда счёт CoinsPay истечёт, полученная часть добавится в счёт, а остаток клиент оплатит, снова нажав «Pay».

  • Каждый платёж один раз

    Вебхук, возврат клиента и опрос могут прийти одновременно, а платёж всё равно добавится один раз. Paymenter до 1.5.7 сам от этого не защищён.

  • Счёт изменился

    Отмените счёт, измените сумму или оплатите его другим способом, и шлюз отменит открытый счёт CoinsPay. Следующее нажатие «Pay» создаст счёт на новую сумму.

  • Платежи на ваше решение

    Платёж за счёт, который успели отменить, не добавляется: иначе Paymenter отметил бы его оплаченным и включил услугу. Не добавляется и то, что больше остатка по счёту. Такие платежи ждут в блоке «Status» со ссылкой на счёт.

  • Ни один платёж не потеряется

    Вебхуки приходят с подписью, и шлюз её проверяет. Даже без вебхуков шлюз каждую минуту спрашивает CoinsPay об открытых счетах через планировщик Paymenter и когда клиент открывает счёт.

  • Комиссию может платить клиент

    Включите эти настройки, и комиссия CoinsPay и комиссия сети прибавятся к сумме на странице оплаты. В счёт Paymenter зачислится его собственная сумма.

  • Всё в одном блоке

    Блок «Status» наверху настроек показывает магазин и режим ключа, адрес вебхука, пришло ли тестовое событие и валюты вашего Paymenter, которые CoinsPay не принимает.

  • Тестовый режим

    С тестовым ключом cpk_test_ счёт оплачивается кнопкой на странице оплаты, монеты не двигаются. Шлюз видят только вошедшие администраторы в своих счетах, настоящие клиенты его не заметят.

Установка

Модуль — один архив на GitHub рядом с исходным кодом. Он ставится как любое расширение Paymenter — загрузкой в админке.

Документация API
Paymenter
1.4.0 и новее, проверен до 1.5.9
PHP
8.2 и новее, как нужно Paymenter
Cron
крон Paymenter, каждую минуту
Лицензия
GPL 3.0

Платите, только когда получаете деньги

  • Первые 10 дней без комиссии, на выплаты до $500
  • Без абонентской платы и платы за подключение
  • Комиссию можно включить в счёт покупателя
  • Комиссия сети по факту, без наценки

от0,3 %с выплаты, ставка зависит от оборота

Подключить магазинКак считается комиссия

Вопросы о шлюзе

Все вопросы
Сколько стоит модуль?

Модуль бесплатный. Вы платите только комиссию CoinsPay с выплат: от 0,3 %, ставка снижается с ростом оборота, абонентской платы нет. Первые 10 дней после первого платежа выплаты до $500 идут без комиссии.

Какие монеты сможет выбрать клиент?

Больше 30 монет и токенов в сетях TRON, Ethereum, BNB Smart Chain, Solana, Bitcoin и Litecoin: USDT, USDC, BTC, ETH, BNB, TRX, LTC, SOL и другие. В настройках шлюза можно оставить только стейблкоины.

Услуга включится сразу после оплаты?

Да. Как только шлюз добавил платёж, счёт оплачен, и Paymenter включает или продлевает услугу, как после любой оплаты, например игровой сервер в Pterodactyl, и пишет клиенту.

Нужен ли cron?

Крон Paymenter нужен ему самому, а шлюз добавляет в его планировщик свою проверку: открытые счета проверяются каждую минуту, даже если вебхук не дошёл. Без крона такой платёж придёт, когда клиент откроет счёт.

Шлюз работает на русском?

Тексты шлюза переведены на русский, но в самом Paymenter русского языка пока нет: админка и кабинет клиента — на английском. Русские тексты шлюза появятся, если добавить в Paymenter русский перевод.

Какие данные клиента уходят в CoinsPay?

Номер счёта, сумма и валюта и адрес, куда вернуть клиента после оплаты. Имена, почта, адреса и телефоны клиентов в CoinsPay не передаются.

Можно подключить тестовую копию Paymenter?

Да, но заведите для неё отдельный магазин в CoinsPay. У магазина один адрес вебхука, и события пришли бы только на один из двух сайтов.

Начните принимать криптовалюту сегодня

Регистрация займёт минуту, настройка магазина ещё пять. За подключение платить не нужно.

Paymenter — проект с открытым кодом, название и логотип Paymenter принадлежат ему. CoinsPay не связан с Paymenter, а модуль не спонсирован и не одобрен его авторами.