Wtyczka MakePay VirtueMart

Przegląd

Wtyczka MakePay VirtueMart dodaje hostowaną metodę płatności kryptowalutą do Joomla sklepy korzystające z VirtueMart. Klienci wybierają MakePay w checkout, płacą na Strona MakePay checkout i powrót do sklepu, podczas gdy VirtueMart utrzymuje zamówienie rekord.

Podpisane powiadomienia o płatnościach aktualizują zamówienie VirtueMart po dokonaniu płatności, więc zespół sklepu może kontynuować zarządzanie zamówieniami w VirtueMart.

Zanim zaczniesz

• Joomla z zainstalowanym VirtueMart
• PHP 7.4 lub nowszy z włączoną obsługą OpenSSL i cURL
• Publiczny adres URL witryny sklepowej HTTPS
• Dostęp do instalacji rozszerzenia Joomla i metod płatności VirtueMart
• Firma MakePay ze skonfigurowanym rozliczeniem i brandingiem

Zainstaluj wtyczkę

Pobierz najnowszy ZIP:

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

W Joomla otwórz System > Rozszerzenia, prześlij plik ZIP, a następnie włącz Płatność VM - Bramka płatności kryptograficznych MakePay z menedżera wtyczek.

W VirtueMart otwórz Metody płatności, utwórz metodę płatności, wybierz wtyczkę płatniczą MakePay i zapisz ją raz, aby VirtueMart przypisał metodę płatności Identyfikator.

Podłącz MakePay

Po zapisaniu metody płatności otwórz adres URL połączenia w witrynie sklepu. Zamień PAYMENT_METHOD_ID na identyfikator metody płatności VirtueMart:

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

MakePay prosi o zalogowanie się, wybranie firmy, która ma otrzymywać płatności, i zatwierdź połączenie. Po zatwierdzeniu wtyczka zapamiętuje połączenie jako włączone tę metodę płatności VirtueMart i konfiguruje adres URL wywołania zwrotnego MakePay.

Ustawienia bramy

Przed publicznym włączeniem metody płatności przejrzyj te pola:

Ustawienie	Zamiar
Metoda połączenia	Użyj Connect MakePay do normalnej konfiguracji lub ręcznych kluczy API jako rozwiązania awaryjnego
Identyfikator firmy MakePay	Wypełniane po połączeniu lub wprowadzane ręcznie w przypadku awarii
Waluta rozliczeniowa	Preferowany składnik rozliczeniowy, taki jak USDT
Wygaśnięcie płatności	Jak długo hostowane łącze checkout pozostaje płatne
Sekret Webhook	Służy do weryfikacji powiadomień o płatnościach MakePay
Statusy zamówień	Statusy VirtueMart dla płatności oczekujących, zapłaconych, zakończonych niepowodzeniem, wygasłych, anulowanych i zwróconych

Przepływ Checkout

Kiedy kupujący wybierze MakePay, wtyczka tworzy łącze do płatności MakePay zawierające:

Pole	Zamiar
source=virtuemart	Identyfikuje integrację
orderId=virtuemart_order_<id>	Mapuje aktywność MakePay z powrotem na VirtueMart
orderNumber	Numer zamówienia VirtueMart pokazywany sprzedawcy
pluginVersion	Zainstalowana wersja wtyczki MakePay
virtuemartVersion	Wersja środowiska wykonawczego VirtueMart, jeśli jest dostępna

Klient zostaje przekierowany do hostowanego checkout. Następnie MakePay wysyła podpisany powiadomienie do punktu końcowego powiadamiania wtyczki VirtueMart.

Stany zamówień

Stan MakePay	Zachowanie VirtueMart
paid, completed, confirmed, succeeded	Przenosi zamówienie do skonfigurowanego statusu opłaconego
expired	Przenosi zamówienie do skonfigurowanego statusu wygasłego
failed	Przenosi zamówienie do skonfigurowanego statusu niepowodzenia
cancelled, canceled	Przenosi zamówienie do skonfigurowanego statusu anulowanego
refunded	Przenosi zamówienie do skonfigurowanego statusu zwrotu środków
Inne statusy	Ignorowane do czasu nadejścia stanu płatności końcowej

Każda aktualizacja zapisuje komentarz do zamówienia prywatnego z transakcją MakePay, kwotą, zasobu i adresu URL płatności, jeśli te pola są obecne.

Ręczne przywracanie klucza API

Jeśli nie można zastosować przepływu połączenia, ustaw Metoda połączenia na Ręczny API klawisz zastępczy i wpisz:

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

Używaj tego tylko w razie potrzeby i ograniczaj dostęp administratora Joomla do zaufanych operatorów.

Rozwiązywanie problemów

Jeśli nie można uruchomić checkout, upewnij się, że metoda płatności ma połączenie firmowe lub ręczne ustawienia klucza API. Jeśli adres URL połączenia nie powiedzie się, potwierdź witrynę sklepową jest publicznym protokołem HTTPS, a wartość pm wskazuje na zapisaną metodę płatności MakePay.

Jeśli zamówienia nie zostaną zaktualizowane, porównaj adres URL wywołania zwrotnego MakePay z adresami URL VirtueMart adres URL powiadomienia wtyczki i zmień sekret webhook z metody płatności ustawienia.