Wtyczki e-commerce
Dostawca płatności XenForo
Zainstaluj i skonfiguruj oficjalnego dostawcę płatności XenForo z natywnymi tokenami OAuth, związanymi z DPoP, hostowanym MakePay checkout i podpisanymi wywołaniami zwrotnymi.
MakePay XenForo Dostawca płatności
Przegląd
Oficjalny dodatek MakePay XenForo dodaje hostowane kryptowaluty checkout do XenForo profile płatności. XenForo tworzy żądanie zakupu, MakePay tworzy hostowane łącze do płatności, a moduł obsługi wywołania zwrotnego płatności XenForo kończy proces zakup po podpisaniu MakePay webhook.
Do normalnej konfiguracji użyj Connect MakePay. Pozostają ręczne poświadczenia klucza API dostępny jako rezerwowy.
Zanim zaczniesz
- XenForo 2.3 lub nowszy
- PHP 8.1 lub nowszy z włączoną obsługą OpenSSL
- Adres URL forum/społeczności HTTPS
- Dostęp administracyjny do profili płatności
- Firma MakePay, w której możesz zarządzać ustawieniami płatności
Zainstaluj dodatek
Pobierz najnowszy pakiet ZIP:
https://plugins.makecrypto.io/downloads/xenforo/latest.zip
Zainstaluj go za pomocą instalatora archiwum dodatku XenForo lub prześlij plik upload/
zawartość katalogu do katalogu głównego XenForo. Identyfikator dodatku to MakePay/Payment,
a źródło jest zainstalowane pod adresem:
src/addons/MakePay/Payment
Podłącz MakePay
Przejdź do Opcje > Usługodawcy > Profile płatności > Dodaj profil płatności i wybierz MakePay. Zapisz profil raz, otwórz go ponownie, a następnie wybierz Połącz MakePay. Dodatek:
- Otwiera MakeCrypto na karcie przeglądarki.
- Prosi Cię o zalogowanie się i wybranie firmy, która ma otrzymywać płatności.
- Pokazuje uprawnienia wymagane przez dostawcę płatności XenForo.
- Po zatwierdzeniu wraca do XenForo.
- Zapisuje połączenie w opcjach profilu płatności.
- Konfiguruje adres URL wywołania zwrotnego MakePay i klucz tajny webhook.
Skonfiguruj MakePay
Po zakończeniu połączenia pozostaw metodę połączenia ustawioną na domyślną połączoną tryb. Recenzja:
- Identyfikator firmy MakePay
- Waluta rozliczeniowa
- Wygaśnięcie linku do płatności
- Adres URL wywołania zwrotnego Webhook
- Ręczne poświadczenia zastępcze klucza API
Ręczne przywracanie awaryjne wymaga identyfikatora firmy MakePay, identyfikatora klucza API, tajnego klucza API oraz Sekret webhook.
Przepływ Checkout
Dodaj profil płatności MakePay do aktualizacji użytkownika XenForo, zasobu płatnego lub kolejny przepływ do kupienia, który obsługuje profile płatności. Kiedy członek wybierze MakePay, dodatek tworzy łącze płatnicze MakePay z metadanymi XenForo.
| Pole | Zamiar |
|---|---|
source=xenforo | Identyfikuje integrację |
orderId=xenforo_purchase_<requestKey> | Mapuje aktywność MakePay z powrotem na XenForo |
requestKey | Klucz żądania zakupu XenForo |
purchasableTypeId | Typ do kupienia XenForo |
moduleVersion | Zainstalowana wersja dodatku MakePay |
xenforoVersion | Wersja środowiska uruchomieniowego XenForo |
Kupujący zostaje przekierowany do hostowanego MakePay checkout i po powrocie wraca do XenForo płatność lub anulowanie.
Stany płatności
MakePay wysyła podpisane wywołania zwrotne do:
https://your-forum.example/payment_callback.php?_xfProvider=makepay
| Stan MakePay | Wynik wywołania zwrotnego XenForo |
|---|---|
paid, completed, confirmed, succeeded | Płatność otrzymana |
failed, expired | Płatność cofnięta |
cancelled, canceled | Płatność cofnięta |
refunded | Płatność cofnięta |
| Inne statusy | Aż do |
XenForo rejestruje dziennik dostawcy płatności z identyfikatorem UID płatności MakePay, zakup klucz żądania, adres URL płatności, jeśli jest dostępny, oraz ładunek wywołania zwrotnego.
Uwagi dotyczące bezpieczeństwa
Dodatek przechowuje szczegóły połączenia w opcjach profilu płatności. Zachowaj Dostęp administratora XenForo jest ograniczony do zaufanych operatorów i odłącza społeczność w MakeCrypto, jeśli ujawniona zostanie kopia zapasowa konta administratora lub serwera.
Połączenie prosi o następujące uprawnienia:
company:readmakepay:payment-links:readmakepay:payment-links:writemakepay:customers:readmakepay:customers:writemakepay:settings:readmakepay:settings:write
Rozwiązywanie problemów
Jeśli nie można uruchomić Connect MakePay, potwierdź, że adres URL karty XenForo to HTTPS i
publicznie osiągalne. Jeżeli brakuje przycisku Połącz MakePay, zapisz płatność
profil i otwórz go ponownie. Jeśli zakupy nie zostaną zakończone, porównaj MakePay
Adres URL wywołania zwrotnego webhook z XenForo
payment_callback.php?_xfProvider=makepay URL i obróć klucz tajny webhook.