Приём криптовалюты в 
FOSSBilling
Шлюз CoinsPay позволяет клиентам оплачивать счета FOSSBilling в USDT, BTC, ETH или другой из 30+ монет. Платёж зачисляется на баланс клиента и оплачивает счёт, FOSSBilling включает или продлевает заказ, а деньги уходят прямо на ваши кошельки.
- FOSSBilling
- 0.8.0 и новее
- PHP
- 8.3 и новее
- Модуль
- бесплатный, GPL 3.0
Что даёт шлюз
Заказы включаются сами
Когда платёж подтверждён, он зачисляется на баланс клиента и оплачивает счёт — так FOSSBilling и оплачивает счета. Дальше FOSSBilling делает то же, что после любой оплаты: включает или продлевает заказ и пишет клиенту. Проверять платежи вручную не нужно.
Деньги сразу на ваших кошельках
CoinsPay не держит выручку у себя: каждая оплата уходит на ваши кошельки по правилу выплат магазина. В каждой сети до 5 адресов с долями, например 70 % вам и 30 % партнёру.
Цены остаются в вашей валюте
Клиент платит остаток по счёту в его валюте за вычетом того, что уже лежит на балансе. CoinsPay пересчитает сумму в монету по текущему курсу и удержит её 30 минут, пока клиент открывает кошелёк.
Ключ, которым нельзя вывести деньги
Шлюзу хватает ключа с доступом «Только счета»: им можно выставлять счета и следить за ними, а вывести деньги нельзя.
Подключение за пять минут
Нужны кабинет CoinsPay с магазином и доступ к админке FOSSBilling. Программист не нужен.
- 01Установите модульСкачайте архив и распакуйте его в корневую папку FOSSBilling, ту, где лежит config.php. Затем откройте «Расширения», найдите CoinsPay и активируйте его.
- 02Добавьте шлюзВ «Система» → «Платежные шлюзы» на вкладке «Новый платежный шлюз» установите Coinspay и задайте название, которое увидят клиенты. В кабинете CoinsPay выпустите ключ с доступом «Только счета» и вставьте его в поле «Ключ API».
- 03Подключите вебхукСкопируйте адрес вебхука со страницы CoinsPay в «Расширениях» в раздел «Вебхук» кабинета, а ключ подписи whsec_ — в поле шлюза «Секрет вебхука».
- 04Сохраните и проверьтеСтраница CoinsPay покажет имя вашего магазина в CoinsPay, боевой режим и последний запуск крона. Отправьте тестовое событие из кабинета, и страница его отметит. Клиенты уже видят CoinsPay среди способов оплаты счёта.
Шлюз справляется и с неудобными случаями
Частичная оплата, изменённый или отменённый счёт, потерянный вебхук: шлюз зачисляет ровно то, что пришло, и ни один платёж не теряется.
Недоплата
Если пришло меньше, клиент может доплатить на той же странице оплаты. Когда счёт CoinsPay истечёт, полученная часть зачислится на баланс клиента, а следующее «Оплатить» попросит только остаток.
Каждый платёж один раз
Вебхук, возврат клиента и опрос могут прийти одновременно, а платёж всё равно зачислится один раз. Сам FOSSBilling от этого не защищён.
Счёт изменился
Отмените или удалите счёт, измените сумму или оплатите его другим способом, и шлюз отменит открытый счёт CoinsPay. Следующее «Оплатить» создаст счёт на новую сумму.
Отменённый счёт не оплачивается
Платёж за счёт, который успели отменить или удалить, зачисляется на баланс клиента, а счёт остаётся неоплаченным: иначе FOSSBilling отметил бы его оплаченным и включил заказ. Переплата тоже остаётся на балансе.
Пополнение баланса
Клиент может пополнить баланс счётом «Пополнить счёт» и оплатить его криптовалютой: платёж станет новым балансом.
Ни один платёж не потеряется
Вебхуки приходят с подписью, и шлюз её проверяет. Даже без вебхуков шлюз спрашивает CoinsPay об открытых счетах при каждом запуске крона FOSSBilling и когда клиент возвращается со страницы оплаты.
Комиссию может платить клиент
Включите эти настройки, и комиссия CoinsPay и комиссия сети прибавятся к сумме на странице оплаты. Счёт в FOSSBilling оплатится на свою сумму.
Всё на одной странице
Страница CoinsPay в «Расширениях» показывает магазин и режим ключа, адрес вебхука, пришло ли тестовое событие, работает ли крон и платежи, на которые стоит посмотреть, со ссылками на счета.
Тестовый режим
С тестовым ключом cpk_test_ счёт оплачивается кнопкой на странице оплаты, монеты не двигаются. Шлюз видят только вошедшие администраторы, настоящие клиенты его не заметят.
Установка
Модуль — один архив на GitHub рядом с исходным кодом. Распакуйте его в корневую папку FOSSBilling: он добавит модуль и платёжный шлюз.
Документация API- FOSSBilling
- 0.8.0 и новее, проверен до 0.8.9
- PHP
- 8.3 и новее, как нужно FOSSBilling 0.8
- Cron
- крон FOSSBilling, каждые 5 минут
- Лицензия
- GPL 3.0
Платите, только когда получаете деньги
- Первые 10 дней без комиссии, на выплаты до $500
- Без абонентской платы и платы за подключение
- Комиссию можно включить в счёт покупателя
- Комиссия сети по факту, без наценки
Вопросы о шлюзе
Все вопросыСколько стоит модуль?
Модуль бесплатный. Вы платите только комиссию CoinsPay с выплат: от 0,3 %, ставка снижается с ростом оборота, абонентской платы нет. Первые 10 дней после первого платежа выплаты до $500 идут без комиссии.
Какие монеты сможет выбрать клиент?
Больше 30 монет и токенов в сетях TRON, Ethereum, BNB Smart Chain, Solana, Bitcoin и Litecoin: USDT, USDC, BTC, ETH, BNB, TRX, LTC, SOL и другие. В настройках шлюза можно оставить только стейблкоины.
Заказ включится сразу после оплаты?
Да. Как только платёж оплатил счёт, FOSSBilling включает или продлевает заказ, как после любой оплаты, например аккаунт хостинга, и пишет клиенту.
Зачем платёж идёт через баланс клиента?
Так FOSSBilling оплачивает счета. Заодно деньги не теряются: платёж за счёт, который успели отменить, остаётся на балансе, и с него оплатится следующий счёт клиента.
Нужен ли cron?
Крон FOSSBilling нужен ему самому, а шлюз при каждом запуске проверяет открытые счета, даже если вебхук не дошёл. Без крона такой платёж придёт, когда клиент вернётся со страницы оплаты.
Шлюз работает на русском?
Да. В FOSSBilling есть русский язык, и шлюз говорит на языке, выбранном в FOSSBilling, а страница оплаты открывается на языке клиента.
Какие данные клиента уходят в CoinsPay?
Номер счёта, сумма и валюта и адрес, куда вернуть клиента после оплаты. Имена, почта, адреса и телефоны клиентов в CoinsPay не передаются.
Можно подключить тестовую копию FOSSBilling?
Да, но заведите для неё отдельный магазин в CoinsPay. У магазина один адрес вебхука, и события пришли бы только на один из двух сайтов.
Начните принимать криптовалюту сегодня
Регистрация займёт минуту, настройка магазина ещё пять. За подключение платить не нужно.
FOSSBilling — проект с открытым кодом, название и логотип FOSSBilling принадлежат ему. CoinsPay не связан с FOSSBilling, а модуль не спонсирован и не одобрен его авторами.