Биллинг хостинга

Криптоплатежи для WISECP

Приём криптовалюты по счетам и заказам WISECP. Клиент выбирает «SnapEX Pay — криптовалюта (USDT и другие монеты)», платит на странице SnapEX Pay в USDT в сетях TRON, Ethereum, BSC и других или в других монетах с конвертацией в USDT, и счёт в WISECP отмечается оплаченным автоматически.

Скачать модуль GitHub

Бесплатно. Версия 1.0.2.

Что умеет модуль

Не нужно держать кошельки и ноды: деньги приходят на баланс мерчанта SnapEX Pay.
Платёж записывается по подписанному вебхуку или сразу, как клиент вернётся со страницы оплаты, — что случится раньше. В обоих случаях счёт сначала перечитывается из API SnapEX Pay: одно тело вебхука ничего не отмечает оплаченным, и платёж никогда не записывается дважды.
Клиент, вернувшийся до подтверждения платежа, видит страницу статуса: она проверяет оплату каждые 10 секунд и сама переходит на страницу WISECP «платёж успешен».
Частичный платёж передаётся в статусе pending с полученной суммой в примечании — на вашу проверку перед одобрением.
Тестовый режим: тестовые счета подтверждаются сами, без настоящих денег; пока он включён, кнопку видит только вошедший администратор.
Без дополнительных таблиц в базе: модуль хранит свои данные в checkout WISECP. Тексты админки — на английском, турецком и русском.
Монеты: USDT (TRC20, ERC20, BEP20) — на счёт любой суммы; BTC, ETH, LTC и TRX — и на меньшие суммы, если позволяет комиссия сети; другие монеты — в счетах от $8.

Установка

Загрузите содержимое архива в корень WISECP с сохранением пути coremio/modules/Payment/SnapexPay/.
В админке WISECP откройте настройки платёжных шлюзов, найдите среди модулей SnapEX Pay (криптовалюта), включите его и откройте настройки. В WISECP 5: Payment Gateways → добавьте модуль в Enabled Module Selection, сохраните и откройте его карточку.
В кабинете мерчанта SnapEX Pay создайте API-ключ с правами invoices.read и invoices.write и вставьте его в поле «API-ключ».
В кабинете добавьте вебхук с адресом, который показан под полем «Секрет вебхука» (https://<ваш WISECP>/payment/SnapexPay/<token>/callback в WISECP 3, …/payments/SnapexPay/<token>/callback в WISECP 5; скопируйте его со страницы настроек), и вставьте секрет whsec_… в поле «Секрет вебхука». Платёж, после которого клиент не вернулся на сайт, приходит именно вебхуком.
Если счета не в USD, оставьте USD среди валют WISECP с курсом: модуль пересчитает сумму в USD по курсам WISECP. Если в шлюзе включена конвертация в USD, WISECP сам передаёт сумму в USD и пересчёт не нужен.
Включите тестовый режим, оставаясь в админке, откройте неоплаченный счёт в клиентской части в том же браузере, оплатите его тестовым методом на странице SnapEX Pay и проверьте, что счёт стал оплаченным. Затем выключите тестовый режим.

Настройки

API-ключ	Из кабинета SnapEX Pay.
Секрет вебхука	`whsec_…` из настроек вебхука в кабинете. Адрес вебхука показан под полем.
Комиссию сети платит	Мерчант — клиент платит ровно сумму счёта. Клиент — комиссия добавляется сверху.
Время на оплату, минут	Сколько действует страница оплаты (1–1440, по умолчанию 60). Повторная оплата позже откроет новую.
Тестовый режим	Тестовые счета, только для вошедших администраторов. После выключения тестовые платежи игнорируются.
Partner ID	Необязательно: Partner ID интегратора, который настроил модуль (реферальная программа SnapEX Pay). Оставьте пустым, если ставите сами.
API URL	Оставьте как есть.

Вопросы

С какими версиями WISECP работает?

С WISECP 3 и WISECP 5. Модуль проверен целиком в настоящей установке WISECP 5.0-beta.3: вебхук, возврат клиента и поздний вебхук после возврата — по одному платежу.

Зачем нужен вебхук?

Если клиент заплатил и не вернулся на сайт, платёж попадает в WISECP через подписанный вебхук. Если клиент вернулся, платёж записывается сразу и никогда не записывается дважды.

Счета не в USD — заработает?

Да. Оставьте USD среди валют WISECP с курсом — модуль пересчитает сумму по курсам WISECP. Или включите в шлюзе конвертацию в USD, и WISECP передаст сумму в USD сам.

Что появляется в WISECP при оплате?

Платёж передаётся как успешный, и WISECP отмечает счёт (или заказ) оплаченным. Номер транзакции — номер счёта SnapEX Pay (INV-…), в примечании к платежу указано, чем заплатил клиент.

Что если клиент заплатил меньше суммы счёта?

Если клиент не доплатит вовремя, платёж передаётся в статусе pending с полученной суммой в примечании. Проверьте его перед одобрением.

Что если страница оплаты истекла без оплаты?

Ничего не записывается, клиент может заплатить заново. Если деньги пришли уже после закрытия счёта, в лог модулей WISECP пишется запись; деньги лежат на вашем балансе SnapEX Pay.

Где посмотреть, что сделал модуль?

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

Другие интеграции

Готовы принимать крипту?

Создайте аккаунт мерчанта, получите API-ключ и подключите модуль. 1% с платежа, без абонентской платы.