Moduł MakePay Magento

Przegląd

Oficjalny moduł MakePay Magento dodaje do hostowanej metody kryptograficznej checkout Magazyny Magento Open Source i Adobe Commerce 2.4.x. Magento tworzy zamówienie, MakePay tworzy hostowane łącze do płatności i podpisane webhooks aktualizuje zamówienie po zmianie statusu płatności.

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

Zanim zaczniesz

• Magento Open Source lub Adobe Commerce 2.4.x
• PHP 8.1 lub nowszy
• Dostęp administracyjny do Sklepy > Konfiguracja > Sprzedaż > Metody płatności
• Firma MakePay, w której możesz zarządzać ustawieniami płatności

Zainstaluj moduł

Pobierz najnowszy ZIP:

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

Wyodrębnij pakiet tak, aby moduł znajdował się pod adresem:

app/code/MakePay/Payment

Włącz go z poziomu roota Magento:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

Podłącz MakePay

Otwórz Sklepy > Konfiguracja > Sprzedaż > Metody płatności > MakePay i wybierz Podłącz MakePay. Moduł:

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 moduł Magento.
4. Po zatwierdzeniu wraca do Magento.
5. Zapisuje połączenie ze sklepem w konfiguracji szyfrowanej Magento.
6. Konfiguruje wywołanie zwrotne MakePay webhook i klucz tajny webhook.

Skonfiguruj MakePay

Po zakończeniu połączenia pozostaw metodę połączenia ustawioną na domyślną połączoną tryb. Włącz metoda płatności i recenzja:

• Nazwa metody płatności
• Doświadczenie Checkout
• Waluta rozliczeniowa
• Wygaśnięcie Linku Płatniczego
• Statusy zamówień: oczekujące, opłacone, zakończone niepowodzeniem, anulowane i zwrócone

Ręczne przywracanie klucza awaryjnego API wymaga identyfikatora firmy MakePay, identyfikatora klucza API, klucza API tajne i tajne webhook.

Przepływ Checkout

Gdy klient wybierze MakePay, Magento umieszcza zamówienie w oczekiwaniu na płatność, następnie otwiera wybrane doświadczenie MakePay checkout. Hostowane przekierowanie to zalecane ustawienie domyślne; osadzony checkout wyświetla bezpieczną stronę MakePay iframe z rezerwowe łącze hostowane.

Ładunek łącza płatniczego obejmuje:

Pole	Zamiar
source=magento	Identyfikuje integrację
orderId=magento_order_<id>	Mapuje aktywność MakePay z powrotem na Magento
incrementId	Czytelny dla człowieka numer zamówienia Magento
magentoOrderAdminUrl	Umożliwia MakeCrypto połączenie administratorów z powrotem do zamówienia Magento
moduleVersion	Zainstalowana wersja modułu MakePay
magentoVersion	Wersja środowiska wykonawczego Magento lub Adobe Commerce

Stany zamówień

Punkt końcowy webhook to /makepay/webhook/index. Weryfikuje Nagłówek X-MakePay-Signature przed aktualizacją zamówienia.

Stan MakePay	Stan Magento
paid, completed, confirmed, succeeded	Przetwarzanie
failed, expired	Odwołany
cancelled, canceled	Odwołany
refunded	Zamknięte
Inne statusy	Oczekująca płatność

Każdy webhook zapisuje prywatny komentarz do historii zamówień ze statusem płatności, publiczny adres URL MakePay checkout, adres URL pulpitu MakeCrypto i dostępny MakePay identyfikatory.

Uwagi dotyczące bezpieczeństwa

Moduł przechowuje szczegóły połączenia w zaszyfrowanej konfiguracji Magento. Zachowaj Dostęp administratora Magento ograniczony do zaufanych operatorów i odłączenie sklepu 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 podstawowy adres URL Magento to HTTPS i publicznie osiągalne. Jeśli przekierowania checkout nie powiodą się, potwierdź, że moduł jest włączony i MakePay ma zapisane połączenie lub ręczne przywrócenie klucza API referencje. Jeśli zamówienia nie zostaną zaktualizowane, porównaj adres URL wywołania zwrotnego webhook w MakePay za pomocą adresu URL Magento /makepay/webhook/index i obróć Sekret webhook.