← Wszystkie wskazówki integracji
PRZECHOWYWANIE PLUGIN · ON- SITE + HPP

Akceptuj płatności kryptowalutowe przez Bagisto 2.3

Pakiet Laravel z rodzimych zamówień i obsługi faktury.

Nowe adaptery to początkowe budowanie integracji. Kompletna instalacja i real- płatności akceptacji w swoim własnym sklepie postojowym przed umożliwienia ruchu na żywo.

Wybierz odpowiedni pakiet i środowisko PHP

Platforma zakupówŚrodowisko PHP dla tego pakietu
Bagisto >=2.3.0 <2.4.0PHP 8.2.x / 8.3.x / 8.4.x (także spełniają blokadę zależności sklepu)

Użyj wersji PHP dozwolonej zarówno przez ten pakiet, jak i Twoje dokładne wydanie rdzenia. Wtyczka nie sprawia, że starszy rdzeń sklepu jest kompatybilny z nowszym PHP.

Nowe pakiety wykorzystują opcjonalną deduplikację request_id i wymagają MochiPay Web65 lub nowszego. Obecni klienci mogą zachować swoje obecne wtyczki i integracje API.

01 · Przygotuj konto MochiPay

  1. Utwórz konto · aktywować subskrypcję.
  2. Portfele · Włącz odbiorczy portfel dla każdego zasobu / sieci, którą oferujesz. Kopia zapasowa materiału do odzysku przed wymeldowaniem.
  3. Kredyty API · Keep klucz handlowy API i sekret na serwerze. Nigdy nie umieszczaj referencji w skryptach HTML lub przeglądarki.

02 · Instalacja i włączenie natywnej bramy

  1. Wyciągnij MochiPay do pakietów / MochiPay. Dodaj lokalne repozytorium ścieżki Kompozytora dla tego katalogu przy jednoczesnym zachowaniu istniejących repozytoriów.
  2. Uruchom kompozytor wymaga mochipay / bagisto- płatności: 1.0.0, php rzemieślnik migrate -- force i php rzemieślnik optymalizacji: jasne.
  3. Otwórz konfigurację > Sprzedaż > Metody płatności > MochiPay. Wprowadź referencje, włącz metodę, wybierz kierunek kwoty i zapisz.
  4. Użyj MySQL / MariaDB. Odkrycie pakietu Laravel rejestruje dostawcę; jeśli odkrycie jest wyłączone, postępuj zgodnie z instrukcjami dostawcy wewnątrz ZIP.

Angielski README wewnątrz każdego ZIP zawiera dokładne ścieżki, natywną konfigurację, zależności i notatki aktualizacji. Podążaj za nim za swoją platformą.

03 · Przegląd domyślnych ustawień

UstawienieWartość domyślna
MochiPay URLhttps://mochi.bz
Tryb płatnościON_SITE
Niepowtarzalny kierunek kwotyUP
Wybrane waluty i sieciUSDT/TRC20 · USDC/ERC20 · BTC/Bitcoin · ETH/Ethereum · SOL/Solana
Brama włączonaWyłączeni, dopóki nie będą gotowe referencje i portfele.

Wprowadź swoje dane uwierzytelniające API, wybierz W GÓRĘ lub W DÓŁ dla Unikalnego kierunku kwoty, włącz MochiPay i zapisz. ON_SITE i wszystkie sześć metod są wstępnie wybrane; oferuj tylko metody z aktywnym portfelem odbiorczym. Natywne ustawienia metody płatności i kanału nadal obowiązują.

04 · ON_SITE i HPP korzystają z tej samej płatności

ON_SITE

Okno płatności w sklepie

Domyślne okno dialogowe ON_SITE pokazuje dokładną kwotę, adres, sieć, kod QR i status płatności w domenie Twojego sklepu.

HPP

Strona płatności MochiPay

HPP otwiera MochiPay payment_url i wraca do Twojego sklepu po realizacji transakcji. Wybierz HPP w tych samych ustawieniach bramy.

Ponowne otwarcie kasy lub zmiana prezentacji powoduje ponowne wykorzystanie zapisanego zlecenia płatniczego. Do parametru MochiPay API nie dodano żadnego parametru payment_mode.

Wypróbuj publiczną symulację ON_SITE/HPP →

05 · Sprawdzić kolejność przed przejściem na żywo

  1. Umieść małe zamówienie. Potwierdź sumę fiat, wybrane aktywa, sieć i dokładną kwotę krypto przed wysłaniem płatności.
  2. Sprawdzić, czy serwer zapytania MochiPay i native paid stan tylko po dopasowanym wyniku PAID. Zwracany adres URL lub organ zwrotny nie jest dowodem zapłaty.
  3. Przetestuj HPP, ON_SITE, ponowne otwarcie kasy i powtarzające się powiadomienia. Potwierdź, że to samo zamówienie zostało ponownie wykorzystane, a zakończenie płatności zostało zastosowane jednokrotnie.

Te pliki do pobrania mają kontrolę źródła / interfejsu i symulowaną walidację checkout. Pełna instalacja natively-store i realny płatny checkout nadal wymagają aprobaty.

Zrozumienie weryfikacji płatności po stronie serwera →

Rozwiązywanie problemów i pobieranie plików

Jeśli brakująca jest bramka, sprawdź dokładną gałąź sklepu, PHP, cache, natywną aktywację metody i ograniczenia kanału. Jeżeli zamówienie pozostaje w toku, sprawdzaj referencje, aktywną subskrypcję, portfele i odtwarzalność połączeń publicznych. Zachować istniejące próby płatności podczas aktualizacji.