Стейблкоїни у твоїй оплаті 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 проєкту/магазину з Магазин → Основне → ID API. Створи дані 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. Використовуй Підключення і Пов’язані платежі для безпечних повідомлень про помилки, посилань на замовлення й перевірок платежів.