Rozszerzenie OpenCart

Przegląd

MakePay dla OpenCart umożliwia sprzedawcom akceptowanie płatności kryptowalutowych za pośrednictwem hostowanych MakePay checkout bez gromadzenia szczegółów płatności w OpenCart. The rozszerzenie pojawia się jako metoda płatności OpenCart, tworzy link do płatności MakePay za każde zamówienie przekierowuje kupującego do MakePay i akceptuje podpisany webhooks aby zaktualizować status zamówienia OpenCart.

Zanim zaczniesz

• OpenCart 4.x
• PHP 8.0 lub nowszy
• HTTPS na interfejsie sklepu
• Firma MakeCrypto z włączoną funkcją MakePay
• Użytkownik MakeCrypto, który może połączyć się z firmą odbierającą
• Opcjonalnie: integracja MakePay API w celu ręcznego przywracania klucza API

OpenCart przechowuje ustawienia rozszerzeń w swojej bazie danych. Zachowaj dostęp do OpenCart administrator ograniczony do zaufanych operatorów, ponieważ szczegóły połączenia, sekrety webhook, oraz opcjonalne poświadczenia zastępcze klucza API są przechowywane w rozszerzeniu płatności ustawienia.

Skonfiguruj MakeCrypto

Dokończ konfigurację sprzedawcy przed podłączeniem OpenCart.

1. Otwórz Strona główna > Sprzedawca > Ustawienia płatności i potwierdź, że MakePay jest włączone.
2. Otwórz Strona główna > Integracje > Integracje API.
3. Potwierdź, że użytkownik łączący OpenCart może zarządzać w tym celu integracjami firma.
4. Opcjonalne rozwiązanie awaryjne: utwórz lub wybierz integrację API, a następnie skopiuj plik identyfikator firmy, identyfikator klucza API i tajny klucz API.

Zainstaluj rozszerzenie

Zalecanym źródłem jest oficjalna lista OpenCart Marketplace:

Otwórz w Eksploratorze rozszerzeń OpenCart

W przypadku instalacji ręcznej pobierz bezpośrednio najnowszy pakiet OpenCart:

Pobierz instrukcję OCMOD ZIP

Następnie zainstaluj go w OpenCart:

1. W panelu administracyjnym OpenCart otwórz Rozszerzenia > Instalator.
2. Prześlij plik makepay.ocmod.zip.
3. Otwórz Rozszerzenia > Rozszerzenia i wybierz Płatności.
4. Znajdź MakePay i kliknij instaluj.
5. Otwórz Edytuj, aby skonfigurować metodę płatności.

Katalog główny pakietu zawiera install.json, admin/ i catalog/, pasujące do Układ instalatora rozszerzeń OpenCart 4.

Podłącz MakePay

W Rozszerzenia > Płatności > MakePay użyj Połącz MakePay. Rozszerzenie:

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 rozszerzenie OpenCart.
4. Po zatwierdzeniu wraca do OpenCart.
5. Zapisuje połączenie ze sklepem i identyfikator firmy.
6. Konfiguruje adres URL wywołania zwrotnego MakePay webhook i klucz tajny webhook.

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

URI przekierowania ma następujący kształt:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.oauth

Skonfiguruj MakePay

W Rozszerzenia > Płatności > MakePay skonfiguruj:

Pole	Wartość
Status	Włączony
Nazwa metody płatności	Etykieta checkout skierowana do kupującego
Metoda połączenia	Podłącz MakePay lub ręczne przywracanie klucza API
Identyfikator firmy MakePay	Wypełniane po połączeniu lub wprowadzane ręcznie dla klucza rezerwowego API
Identyfikator klucza API	Identyfikator klucza integracji API wyłącznie do celów awaryjnych
Tajny klucz API	Sekret integracji API tylko do celów awaryjnych
Sekret Webhook	Ustawiane podczas połączenia lub wprowadzane ręcznie w przypadku połączenia awaryjnego
Podstawowy adres URL API	https://www.makecrypto.io
Waluta rozliczeniowa	Domyślny składnik rozliczeniowy, na przykład USDT
Wygaśnięcie linku do płatności	Na przykład 12h
Doświadczenie Checkout	Hostowane przekierowanie lub osadzone checkout z bezpiecznym iframe i zastępczym łączem hostowanym

Domyślna nazwa metody płatności to:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Skonfiguruj webhooks

Skopiuj adres URL webhook pokazany na stronie ustawień OpenCart MakePay. Ma to kształt:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.webhook

Connect MakePay automatycznie konfiguruje to wywołanie zwrotne. Do ręcznego klucza API awaryjnie, dodaj go do ustawień MakePay webhook z tym samym kluczem tajnym webhook wpisany w OpenCart.

Rozszerzenie weryfikuje X-MakePay-Signature przed aktualizacją zamówienia. The podpis używa formatu HMAC ze znacznikiem czasu:

t=1760000000,v1=<hex-hmac>

Przepływ Checkout

Gdy kupujący wybierze MakePay:

1. OpenCart sprawdza aktywne zamówienie i wybraną metodę płatności.
2. Rozszerzenie wywołuje partnera MakePay API w celu utworzenia łącza płatniczego.
3. Zamówienie zostaje przeniesione do skonfigurowanego statusu oczekującego.
4. Kupujący otwiera wybrane doświadczenie MakePay checkout.
5. Podpisany webhook aktualizuje zamówienie OpenCart po zmianie statusu płatności.

Link do płatności zawiera metadane:

Metadane	Zamiar
source=opencart	Identyfikuje integrację
orderId	Identyfikator zamówienia OpenCart
storeId	Identyfikator sklepu OpenCart
storeName	Nazwa sklepu
storeUrl	Adres URL interfejsu sklepu
opencartOrderId	Identyfikator zamówienia OpenCart dla panelu kontrolnego i dopasowania webhook
opencartOrderAdminUrl	Adres URL zamówienia administratora używany przez akcję Pokaż zamówienie MakeCrypto
storeOrderAdminUrl	Ogólny zastępczy adres URL zamówienia administratora dla połączonych sklepów
moduleVersion	Wersja rozszerzenia MakePay OpenCart
opencartVersion	Wersja środowiska uruchomieniowego OpenCart

Stany zamówień

Skonfiguruj mapowanie stanu w ustawieniach rozszerzenia.

Stan MakePay	Stan OpenCart
paid, completed, confirmed, succeeded	Stan płatny
failed, expired, chargeback	Stan nieudany
cancelled, canceled	Stan anulowany
refunded	Stan zwrócony
Dowolny status w toku	Stan oczekujący

Rozszerzenie dodaje komentarz historii zamówień zawierający status MakePay, UID lub identyfikator płatności, kwota, zasób i hostowany adres URL checkout, jeśli są obecne w Ładunek webhook. Początkowy wpis historii checkout obejmuje również wpis publiczny adres URL płatności i łącze do płatności w panelu MakeCrypto, gdy odpowiedź API zapewnia jeden.

Uwagi dotyczące bezpieczeństwa

• Użyj protokołu HTTPS dla adresów URL checkout i webhook.
• Ogranicz dostęp administratora OpenCart, ponieważ szczegóły połączenia są opcjonalne Poświadczenia API są przechowywane w ustawieniach OpenCart.
• Unieważnij połączoną aplikację OpenCart z MakeCrypto, jeśli masz konto administratora OpenCart jest skompromitowany.
• Obróć klucz MakePay API, jeśli ujawnione zostaną poświadczenia awaryjne ręcznego klucza API.
• Zachowaj klucz tajny webhook inny niż klucz tajny API.
• Nieoczekiwane błędy podpisu webhook traktuj jako niezgodność poświadczeń lub możliwa próba fałszerstwa.

Rozwiązywanie problemów

Jeśli metoda płatności nie jest widoczna, potwierdź, że MakePay jest włączone, a suma koszyka jest włączona spełnia skonfigurowane minimum, a adres klienta jest zgodny ze skonfigurowanym strefa geograficzna.

Jeśli Połączenie MakePay nie powiedzie się, potwierdź, że adres URL sklepu OpenCart to HTTPS i przeglądarka powraca do adresu URL wywołania zwrotnego pokazanego powyżej.

Jeśli checkout nie przekierowuje, potwierdź, że sklep jest podłączony. Do ręcznego awaryjnie, potwierdź identyfikator firmy, identyfikator klucza API, klucz tajny klucza API, podstawowy adres URL API i Uprawnienia integracji MakePay API.

Jeśli zamówienia nie zostaną zaktualizowane po dokonaniu płatności, potwierdź, że adres URL webhook jest osiągalny publicznie przez HTTPS, a klucz tajny webhook w MakePay odpowiada zapisanemu sekretowi w OpenCart.

Jeśli OpenCart zgłosi błąd instalatora, potwierdź, że pobrany plik kończy się na .ocmod.zip i zawiera install.json, admin/ i catalog/ w ZIP korzeń.