Brama MakePay WHMCS

Przegląd

Oficjalna bramka MakePay WHMCS dodaje hostowane kryptowaluty checkout do WHMCS faktury. WHMCS renderuje przycisk płatności na fakturze, MakePay tworzy hostowany link do płatności, a podpisane wywołanie zwrotne oznacza fakturę zapłaconą po płatność zostaje uregulowana.

Do normalnej konfiguracji użyj Connect MakePay. Pozostają ręczne poświadczenia klucza API dostępny jako rezerwowy.

Zanim zaczniesz

• WHMCS 8.13 LTS lub WHMCS 9.x
• PHP 8.1 lub nowszy z włączoną obsługą OpenSSL
• Adres URL systemu HTTPS WHMCS
• Dostęp administratora WHMCS do bramek płatniczych
• Firma MakePay, w której możesz zarządzać ustawieniami płatności

Zainstaluj bramkę

Pobierz najnowszy pakiet ZIP:

https://plugins.makecrypto.io/downloads/whmcs/latest.zip

Wyodrębnij plik ZIP i prześlij katalog modules do katalogu głównego WHMCS. The pakiet instaluje te pliki:

modules/gateways/makepay.php
modules/gateways/makepay/checkout.php
modules/gateways/makepay/oauth.php
modules/gateways/makepay/lib/*.php
modules/gateways/callback/makepay.php

W WHMCS otwórz Ustawienia systemowe > Bramki płatnicze, aktywuj MakePay, a następnie zapisz ustawienia bramy.

Podłącz MakePay

Otwórz ustawienia bramy MakePay i wybierz opcję Połącz MakePay. Brama:

1. Otwiera MakeCrypto na karcie przeglądarki.
2. Prosi Cię o zalogowanie się i wybranie firmy, która ma otrzymywać płatności.
3. Pokazuje uprawnienia wymagane przez bramę WHMCS.
4. Po zatwierdzeniu wraca do WHMCS.
5. Zapisuje połączenie w ustawieniach bramy WHMCS.
6. 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
• Aktywa rozliczeniowe
• Wygaśnięcie płatności
• Stan połączenia MakePay
• Sekret podpisywania Webhook

Ręczne przywracanie awaryjne wymaga identyfikatora firmy MakePay, identyfikatora klucza API, tajnego klucza API oraz Sekret webhook.

Przepływ Checkout

Kiedy klient otwiera niezapłaconą fakturę WHMCS, bramka MakePay wyświetla przycisk płatności. Procedura obsługi checkout sprawdza ładunek podpisanego formularza, ładuje faktura poprzez lokalne pomocniki WHMCS API, tworzy łącze do płatności MakePay, i przekierowuje klienta do hostowanego MakePay checkout.

Pole	Zamiar
source=whmcs	Identyfikuje integrację
orderId=whmcs_invoice_<invoiceId>	Mapuje aktywność MakePay z powrotem na WHMCS
invoiceId	Identyfikator faktury WHMCS
clientId	Identyfikator klienta WHMCS
moduleVersion	Zainstalowana wersja bramy MakePay
whmcsVersion	Wersja środowiska uruchomieniowego WHMCS

Kupujący wraca do oryginalnej faktury WHMCS po dokonaniu płatności lub anulowaniu.

Stany faktur

MakePay wysyła podpisane wywołania zwrotne do:

https://billing.example.com/modules/gateways/callback/makepay.php

Stan MakePay	Zachowanie WHMCS
paid, completed, confirmed, succeeded	Wywołuje addInvoicePayment i rejestruje identyfikator transakcji
failed, expired	Rejestruje oddzwonienie i pozostawia fakturę niezapłaconą
cancelled, canceled	Rejestruje oddzwonienie i pozostawia fakturę niezapłaconą
refunded	Rejestruje wywołanie zwrotne w celu ręcznego sprawdzenia
Inne statusy	Zalogowane i ignorowane

Dzienniki transakcji WHMCS zawierają ładunek wywołania zwrotnego MakePay, dzięki czemu zespoły wsparcia mogą śledzenie UID płatności, metadanych faktury, kwoty i statusu.

Uwagi dotyczące bezpieczeństwa

Brama przechowuje szczegóły połączenia w ustawieniach bramy WHMCS. Zachowaj WHMCS dostęp administratora ograniczony do zaufanych operatorów i odłącz bramę MakeCrypto, jeśli ujawniono kopię zapasową konta administratora lub serwera.

Połączenie prosi o następujące uprawnienia:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

Rozwiązywanie problemów

Jeśli nie można uruchomić Connect MakePay, potwierdź, że adres URL systemu WHMCS to HTTPS i odpowiada publicznej domenie rozliczeniowej. Jeśli klienci zobaczą błąd checkout, potwierdź bramka jest aktywna, faktura jest niezapłacona, a identyfikator firmy MakePay jest zapisany. Jeśli wywołania zwrotne nie oznaczają opłaconych faktur, porównaj adres URL wywołania zwrotnego MakePay z powyższy adres URL wywołania zwrotnego WHMCS i zmień klucz tajny webhook z bramy ustawienia.