Brama MakePay Blesta

Oficjalna bramka MakePay Blesta umożliwia klientom płacenie faktur Blesta za pośrednictwem hostowane kryptowaluty checkout. Blesta tworzy fakturę i jest jej właścicielem. MakePay tworzy plik checkout i wysyła aktualizacje płatności z powrotem do Blesta.

Rozliczenia cykliczne pozostają w ramach Blesta. Kiedy Blesta tworzy fakturę za odnowienie, bramka obsługuje ją jak każdą inną płatność za fakturę.

Zanim zaczniesz

Potrzebujesz:

• Blesta 5.x lub nowszy
• Instalacja HTTPS Blesta
• Dostęp administratora do bramek płatniczych Blesta
• Skonfigurowano rozliczenie i branding MakePay

Zainstaluj bramkę

Pobierz najnowszy pakiet:

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

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

Blesta/components/gateways/nonmerchant/makepay

W Blesta otwórz Ustawienia > Bramki płatnicze, wybierz Dostępne, znajdź MakePay i zainstaluj go jako bramę inną niż handlowa.

Podłącz MakePay

Otwórz ustawienia bramy MakePay w Blesta i kliknij Połącz MakePay.

Przepływ połączenia:

1. Otwiera stronę połączenia MakePay.
2. Pozwala wybrać firmę, która ma otrzymać płatność.
3. Po zatwierdzeniu wraca do Blesta.
4. Zapisuje połączenie bramy dla tej instalacji Blesta.

Po połączeniu utwórz małą fakturę testową i opłać ją ze strefy klienta.

Ręczne przywracanie klucza API

Zalecaną konfiguracją jest Connect MakePay. Dostępna jest ręczna konfiguracja klucza API sklepy, które nie mogą zrealizować połączenia z przewodnikiem.

W przypadku konfiguracji ręcznej ustaw metodę połączenia na Klucz ręczny API i wprowadź:

• Identyfikator firmy MakePay
• Identyfikator klucza API
• Tajny klucz API
• Sekret podpisywania Webhook

Zachowaj dostępność adresu URL wywołania zwrotnego wyświetlanego w Blesta z publicznego Internetu.

Przepływ Checkout

Gdy klient wybierze MakePay dla faktury Blesta, bramka:

1. Odczytuje kwotę faktury, walutę, identyfikator klienta i metadane faktury.
2. Tworzy hostowane łącze do płatności MakePay.
3. Wyświetla przycisk Zapłać za pomocą MakePay.
4. Wysyła klienta do hostowanego checkout.
5. Otrzymuje podpisane wywołanie zwrotne w przypadku zmiany statusu płatności.

Link do płatności zawiera metadane takie jak:

Pole	Zamiar
source=blesta	Identyfikuje integrację
orderId=blesta_invoice_<invoiceId>	Mapuje aktywność MakePay z powrotem na Blesta
invoiceId	Podstawowy identyfikator faktury Blesta
clientId	Identyfikator klienta Blesta, jeśli jest dostępny

Stany faktur

Stan MakePay	Zachowanie Blesta
paid, completed, confirmed, succeeded	Rejestruje zatwierdzoną transakcję
pending, waiting, confirming	Utrzymuje płatność oczekującą
failed, expired, cancelled	Rejestruje odrzuconą płatność

Blesta pozostaje odpowiedzialny za aktywację usługi i cykliczne rozliczenia automatyzacja po opłaceniu faktury.

Uwagi dotyczące bezpieczeństwa

Użyj protokołu HTTPS, ogranicz dostęp administratora Blesta i odłącz bramę z panelu kontrolnego MakePay, jeśli jest to kopia zapasowa konta administratora lub serwera odsłonięte. Połącz się ponownie po zmianie domeny Blesta, aby wywołać zwrotne i zwrócić adresy URL dopasować do instalacji na żywo.

Rozwiązywanie problemów

Jeśli nie można uruchomić Connect MakePay, potwierdź, że adres URL wywołania zwrotnego Blesta jest publiczny a brama jest zainstalowana jako brama niehandlowa.

Jeśli faktury nie aktualizują się, sprawdź, czy adres URL wywołania zwrotnego pokazany w ustawieniach to osiągalny i że obecny jest klucz podpisywania webhook.

Jeśli klienci zobaczą błąd checkout, potwierdź, że MakePay jest podłączony i wybrany waluta faktury jest obsługiwana przez konfigurację MakePay.