Перейти к содержимому
ВойтиРегистрация

Принимайте криптоплатежи по счетам FOSSBilling

Достаточно аккаунта Cryptonly и API-ключа. Установите адаптер — и счета FOSSBilling можно оплачивать криптовалютой. Ниже весь процесс настройки.

Как начать принимать криптоплатежи в FOSSBilling

  1. Зарегистрируйте аккаунт Cryptonly

    Создайте мерчант-аккаунт в панели Cryptonly. Этот аккаунт выдаёт API-ключ, идентификатор аккаунта и ключ подписи вебхука, которые нужны в шагах ниже.

  2. Создайте API-ключ

    Создайте ключ в Settings → Security → API keys со скоупами accounts.list, invoices.create и invoices.list. Скопируйте идентификатор аккаунта в Accounts и ключ подписи вебхука в Settings → Security. Сохранение шлюза без этого ключа подписи блокируется.

  3. Установите адаптер FOSSBilling

    Скачайте адаптер из каталога расширений FOSSBilling и распакуйте архив в корень FOSSBilling, чтобы он слился с существующей папкой library. Установите Cryptonly в System → Payment gateways → New payment gateway. Путь загрузки и поля шлюза описаны в руководстве по интеграции FOSSBilling.

    library/Payment/Adapter/Cryptonly/Cryptonly.php

  4. Сохраните настройки шлюза

    Укажите API-ключ, идентификатор аккаунта и ключ подписи вебхука. Оставьте секрет пустым при следующем сохранении, чтобы сохранить записанное значение. Включайте Test mode только для ключей песочницы Cryptonly. Адаптер проверяет ключ и идентификатор аккаунта через GET /accounts, когда вы его сохраняете.

  5. Принимайте оплату по счетам

    Укажите публичный HTTPS-адрес сайта FOSSBilling, чтобы Cryptonly мог доставить вебхук. На счёте клиент платит на странице оплаты. Подписанный вебхук invoice.statusChanged зачисляет сумму, которая ещё должна, как кредит аккаунта и оплачивает счёт этим кредитом. Короткая оплата зачисляется как кредит, а счёт остаётся неоплаченным. Возврат со страницы оплаты не отмечает счёт оплаченным. Адаптер отправляет этот URL вебхука с каждым счётом.

    {siteurl}ipn.php?gateway_id={gateway_id}&invoice_id={invoice_id}

Что такое FOSSBilling

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

Платёжный адаптер лежит в library/Payment/Adapter. Его распаковывают в эту папку, включают в Payment gateways, и клиент видит его при оплате счёта.

Cryptonly использует этот адаптер. Суммы счетов остаются в валюте счёта. Клиент платит на странице Cryptonly. Короткая оплата становится кредитом аккаунта, а подписанный вебхук оплачивает счёт, когда кредит покрывает сумму.

Какую криптовалюту можно принимать в FOSSBilling с Cryptonly?

Все валюты
BitcoinBTC81 284,70 $-2,86%EthereumETH2 375,06 $-5,45%TetherUSDT0,998781 $-0,03%USD CoinUSDC1,0012 $+0,03%BNBBNB722,29 $-2,75%TRONTRX0,3326 $-0,12%ChainlinkLINK12,152 $-6,30%

Вопросы о FOSSBilling

  • Какие версии FOSSBilling поддерживает адаптер?

    FOSSBilling 0.7 или новее на PHP 8.2 или новее.

  • Нужно ли собирать свою страницу крипто-оплаты?

    Нет. Клиент платит на странице оплаты Cryptonly и возвращается к счёту. Экран кошелька и слежение за сетью делать не нужно.

  • Сколько это стоит?

    0,5% с каждого платежа, без платы за подключение и без ежемесячной платы.

  • Можно ли проверить адаптер до реальных платежей?

    Да. В тестовом режиме проходят и страница оплаты, и вебхук, но через песочницу Cryptonly. Тестовый режим выключают и переключают ключи на боевые, когда биллинг готов принимать живые платежи.

  • Суммы счетов должны быть в криптовалюте?

    Нет. Счета остаются в валюте счёта. Cryptonly пересчитывает сумму в момент оплаты.

  • Как FOSSBilling узнаёт, что счёт оплачен?

    Cryptonly отправляет подписанный вебхук invoice.statusChanged на ipn.php. Статусы paid и overpaid зачисляют сумму, которая ещё должна, как кредит аккаунта, а затем оплачивают счёт этим кредитом. Переплата не сохраняется как лишний кредит. Частичная оплата зачисляется как кредит, а счёт остаётся неоплаченным. Возврат со страницы оплаты не отмечает счёт оплаченным.

  • Cryptonly сам списывает продление подписки?

    Нет. Подписки выключены. Счёт на продление оплачивается новой ссылкой на оплату.

Принимайте криптоплатежи с FOSSBilling и Cryptonly

Страница оплаты, подписанные вебхуки и комиссия 0,5%. Короткая оплата становится кредитом аккаунта, а FOSSBilling оплачивает счёт, когда кредит покрывает сумму.