Стейблкоины на платёжной странице BTCPay.

Установить

1. Скачай BTCPayServer.Plugins.WhollyCrypto.btcpay и проверь по файлу релиза SHA256SUMS. Используй файл плагина, а не ZIP исходников GitHub.
2. От имени администратора BTCPay открой Управление плагинами → Загрузить плагин, загрузи файл и перезапусти BTCPay.
3. Выбери магазин → Плагины → Wholly Crypto. Сама установка не подключает магазин.

Обновления устанавливаются той же загрузкой файла. Обновление Wholly для продавца не обновляет плагин BTCPay.

Подключение магазина

1. В Wholly создай включённые проект и магазин с разрешёнными способами оплаты, резервными копиями кошельков, курсами и подтверждениями. Используй актуальную установку продавца; коннектор рассчитан на API 6.4.5.
2. Скопируй UUID проекта и магазина из Магазин → Основное → API ID. Создай API-ключ с чтением и записью только для этого проекта. Включи Магазин → IPN и скопируй его секрет подписи, а не секрет вебхука.
3. В настройках Wholly в BTCPay введи эти значения и адреса origin API и платёжных страниц, например https://api.example.com и https://pay.example.com. Используй публичный HTTPS на порту 443, без пути.
4. Включи Предлагать Wholly Crypto при оплате, сохрани, затем нажми Проверить доступ на чтение. При желании выбери часть разрешённых магазином способов оплаты.

Разреши HTTPS-уведомления с сервера Wholly на BTCPay в обоих файрволах. Плагин задаёт URL уведомлений. На этом маршруте не должно быть браузерного входа, CAPTCHA или Basic Auth; проверка подписи должна оставаться включённой.

Встроенная платёжная страница

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

1. В Wholly открой Магазин → Дополнительнои включи Разрешить встроенную оплату. Добавь точный HTTPS-origin своего BTCPay в Разрешённые HTTPS-origin, без пути и подстановочных знаков.
2. В настройках плагина BTCPay выбери Оплата покупателя → Встроенная страница (iframe) и сохрани.
3. Проверь новый счёт. Существующие счета сохраняют прежний режим отображения. Открыть полную страницу оплаты остаётся доступным для того же счёта, если встроенная страница не загружается.

Сообщения браузера и ссылки возврата служат навигацией, но никогда не доказывают оплату.

Проверка процесса оплаты

Создай в тестовом магазине счёт на небольшую положительную сумму в фиате. Выбери Стейблкоины и криптовалюта · Wholly. Проверь страницу оплаты, подписанный IPN и API до подтверждения. Выполняй заказ только по окончательно оплаченному счёту BTCPay и один раз на заказ.

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