Stablecoiny w twoich płatnościach BTCPay.

Zainstaluj

1. Pobierz BTCPayServer.Plugins.WhollyCrypto.btcpay i sprawdź względem pliku wydania SHA256SUMS. Użyj pliku wtyczki, nie ZIP-a z kodem źródłowym z GitHuba.
2. Jako administrator BTCPay otwórz Zarządzaj wtyczkami → Prześlij wtyczkę, prześlij plik i uruchom BTCPay ponownie.
3. Wybierz sklep → Wtyczki → Wholly Crypto. Sama instalacja nie łączy sklepu.

Aktualizacje korzystają z tego samego procesu przesyłania. Aktualizacja oprogramowania sprzedawcy Wholly nie aktualizuje wtyczki BTCPay.

Połącz sklep

1. W Wholly utwórz włączony projekt/sklep z akceptowanymi metodami, kopiami portfeli, kursami i potwierdzeniami. Używaj aktualnej instalacji sprzedawcy; ten łącznik jest przeznaczony dla API 6.4.5.
2. Skopiuj UUID projektu/sklepu z Sklep → Podstawowe → ID API. Utwórz dane dostępu API z odczytem/zapisem, ograniczone do projektu. Włącz Sklep → IPN i skopiuj sekret podpisywania, nie sekret webhooka.
3. W ustawieniach Wholly w BTCPay wpisz te wartości oraz originy API i płatności, na przykład https://api.example.com i https://pay.example.com. Używaj publicznego HTTPS na porcie 443; bez ścieżek.
4. Włącz Oferuj Wholly Crypto przy płatności, zapisz, a następnie Testuj dostęp do odczytu. Opcjonalnie wybierz podzbiór metod akceptowanych przez sklep.

Zezwól na callbacki HTTPS z serwera Wholly do BTCPay przez obie zapory. Wtyczka podaje URL callbacka. Wyłącz logowanie przeglądarkowe, CAPTCHA i Basic Auth na tej trasie; weryfikacja podpisu musi pozostać włączona.

Osadzona strona płatności

Domyślnie płatność otwiera się na całej stronie, co jest szczególnie przydatne dla mobilnych aplikacji portfelowych. Dla iframe:

1. W Wholly, w Sklep → Zaawansowane, włącz Zezwalaj na osadzoną stronę płatności. Dodaj dokładny origin HTTPS BTCPay do Dozwolone originy HTTPS, bez ścieżki ani symbolu wieloznacznego.
2. W ustawieniach wtyczki BTCPay wybierz Płatności klienta → Osadzona strona płatności (iframe) i zapisz.
3. Przetestuj nową fakturę. Istniejące faktury zachowują pierwotny tryb wyświetlania. Otwórz pełną stronę płatności pozostaje dostępne dla tej samej faktury, jeśli ramka nie może się załadować.

Komunikaty przeglądarki i linki powrotne służą nawigacji, nigdy jako dowód zapłaty.

Sprawdź proces płatności

Utwórz małą fakturę fiat z dodatnią kwotą w sklepie testowym. Wybierz Stablecoiny i krypto · Wholly. Zweryfikuj stronę płatności, podpisane IPN i weryfikację API aż do potwierdzenia. Realizuj tylko na podstawie rozliczonej faktury BTCPay, raz na zamówienie.

Testuj dostęp do odczytu nie testuje tworzenia faktur ani IPN. Użyj Połączenie i Powiązane płatności aby sprawdzić bezpieczne komunikaty błędów, referencje zamówień i płatności.