Brama MakePay ClientExec

Przegląd

Oficjalna bramka MakePay ClientExec dodaje hostowane kryptowaluty checkout do Faktury ClientExec. ClientExec tworzy fakturę, bramka tworzy Link do płatności MakePay i podpisane wywołania zwrotne oznaczają fakturę zapłaconą po płatność zostaje uregulowana.

Rozliczenia cykliczne pozostają w ramach ClientExec. Kiedy ClientExec tworzy każde odnowienie fakturę, ten sam przepływ bramy MakePay pozwala klientowi zapłacić tę fakturę.

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

Zanim zaczniesz

• ClientExec 6.8 lub nowszy, w tym ClientExec 7.x
• PHP 7.4 lub nowszy z włączoną obsługą OpenSSL i cURL
• Adres URL HTTPS ClientExec
• Dostęp administratora ClientExec do procesorów płatności
• Firma MakePay, w której możesz zarządzać ustawieniami płatności

Zainstaluj bramkę

Pobierz najnowszy pakiet ZIP:

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

Wyodrębnij plik ZIP i prześlij folder makepay do:

ClientExec/plugins/gateways/makepay

Pakiet instaluje następujące pliki:

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

W ClientExec otwórz Ustawienia > Wtyczki > Procesory płatności, wybierz MakePay, i zapisz ustawienia procesora płatności.

Podłącz MakePay

Otwórz ustawienia procesora płatności MakePay i skopiuj plik Connect MakePay URL w przeglądarce. Brama:

1. Otwiera stronę połączenia MakePay.
2. Prosi Cię o zalogowanie się i wybranie firmy, która ma otrzymywać płatności.
3. Pokazuje uprawnienia wymagane przez bramę ClientExec.
4. Po zatwierdzeniu wraca do ClientExec.
5. Zapisuje połączenie w instalacji ClientExec.
6. Konfiguruje adres URL wywołania zwrotnego MakePay i klucz tajny webhook.

Skonfiguruj MakePay

Po zakończeniu połączenia pozostaw metodę uwierzytelniania ustawioną na oauth. Recenzja:

• Identyfikator firmy MakePay
• Aktywa rozliczeniowe
• Wygaśnięcie płatności
• Sekret podpisywania Webhook
• Nazwa rejestracyjna pokazywana klientom

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

Przepływ Checkout

Kiedy klient płaci niezapłaconą fakturę ClientExec za pomocą MakePay, bramka tworzy hostowane łącze płatnicze i przekierowuje klienta do MakePay checkout.

Pole	Zamiar
source=clientexec	Identyfikuje integrację
orderId=clientexec_invoice_<invoiceId>	Mapuje aktywność MakePay z powrotem na ClientExec
invoiceId	Numer faktury ClientExec
clientId	Identyfikator klienta ClientExec, jeśli jest dostępny
moduleVersion	Zainstalowana wersja bramy MakePay
clientexecVersion	Wersja środowiska wykonawczego ClientExec, jeśli jest dostępna

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

Powtarzające się faktury

ClientExec pozostaje odpowiedzialny za produkty powtarzające się, daty odnowienia, podatki, generowanie faktur i e-maili klientów. MakePay nie tworzy osobnego pliku harmonogram subskrypcji w wersji 1.

Dla każdej faktury cyklicznej tworzonej przez ClientExec bramka MakePay zachowuje się jak tak samo jak faktura jednorazowa: tworzy hostowane łącze checkout i czeka na podpisane oddzwonienie przed oznaczeniem faktury jako opłaconej.

Stany faktur

MakePay wysyła podpisane wywołania zwrotne do:

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

Stan MakePay	Zachowanie ClientExec
paid, completed, confirmed, succeeded	Wywołuje akceptację płatności ClientExec 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

Uwagi dotyczące bezpieczeństwa

Bramka przechowuje szczegóły połączenia w instalacji ClientExec. Zachowaj Dostęp administratora ClientExec ograniczony do zaufanych operatorów i rozłączenie bramę z panelu kontrolnego MakePay, jeśli jest to konto administratora lub kopia zapasowa serwera odsłonięte.

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 ClientExec jest publiczny HTTPS a folder makepay jest przesyłany pod plugins/gateways. Jeśli klienci zobaczą Błąd checkout, potwierdź, że MakePay jest podłączony i faktura jest niezapłacona. Jeśli wywołania zwrotne nie oznaczają opłaconych faktur, porównaj adres URL wywołania zwrotnego MakePay z URL wywołania zwrotnego powyżej i zmień klucz tajny webhook w ustawieniach bramy.