Alla Integration Guides
LAGA PLUGIN · PÅ SITE + HPPTa emot kryptobetalningar med Drupal Commerce
Native Commerce betalning gateway för de stödda Drupal och Commerce grenar.
Nya adaptrar är initial integration bygger. Komplett installation och betalningsacceptans i din egen staging butik innan du aktiverar levande trafik.
Välj rätt paket- och PHP-miljö
| Shopping plattform | PHP miljö för detta paket |
|---|
| Kommers 2.40.x med Drupal 9.3-10.x; eller Commerce 3.3.10+ <3.4 med Drupal 10.3-11.x | Drupal 9.3–9.5: PHP 7.4–8.1; Drupal 10: PHP 8.1–8.3; Drupal 11: PHP 8.3–8.4, endast när den tillåts av den exakta Drupal-utgåvan |
|---|
Använd PHP-versionen tillåten av både detta paket och din exakta kärnutgåva. En plugin gör inte en äldre butik kärna kompatibel med nyare PHP.
Nya paket använder valfri request_id-deduplicering och kräver MochiPay Web65 eller senare. Befintliga kunder kan behålla sina nuvarande plugins och API-integrationer.
01 · Förbered ditt MochiPay-konto
- Skapa ett konto · aktivera ett abonnemang.
- Plånböcker Möjliggöra en mottagande plånbok för varje tillgång/nätverk du kommer att erbjuda. Tillbaka upp återställningsmaterial före kassan.
- API-uppgifter Håll köpmannen API-nyckeln och hemligheten på servern. Placera aldrig referenser i kassan HTML eller webbläsarskript.
02 · Installera och aktivera den inhemska porten
- Extrahera mochipay till webb/moduler/anpassad/mochipay, eller moduler/anpassad/mochipay när din projektrot är dokumentroten.
- Run drush en mochipay -y, drush cr. Installatören behåller befintlig betalningsförsök lagring.
- Skapa en MochiPay-gateway i Handel > Konfiguration > Betalningsgateways. Håll inbyggt gateway-läge Live; denna inställning är oberoende av ON_SITE/HPP.
- Möjliggöra både gatewayenheten och aktivera MochiPay, ange referenser och spara. Håll /mochipay/checkout/{gateway-machine-name} offentlig och uncached.
Den engelska README inuti varje ZIP innehåller exakta vägar, inhemsk konfiguration, beroenden och uppgradera anteckningar. Följ den för din plattform.
04 · ON_SITE och HPP använder samma betalning
ON_SITEBetalningsdialog i din butik
Standarddialogrutan ON_SITE visar exakt belopp, adress, nätverk, QR och betalningsstatus på din butiksdomän.
HPPMochiPay värd betalningssida
HPP öppnar MochiPay payment_url och återvänder till din butik efter kassan. Välj HPP i samma gatewayinställningar.
Om du öppnar kassan igen eller byter presentation återanvänds den sparade betalningsordern. Ingen payment_mode-parameter läggs till i MochiPay API.
Prova den offentliga ON_SITE/HPP-simuleringen →
05 · Verifiera en staging order innan du går live
- Placera en liten staging order. Bekräfta fiat totalt, vald tillgång, nätverk och exakt kryptobelopp innan du skickar betalning.
- Kontrollera att servern frågar MochiPay och registrerar det ursprungliga betalda tillståndet först efter ett matchat PAID-resultat. En retur URL eller callback kropp ensam är inte betalningsbevis.
- Testa HPP, ON_SITE, återöppning av kassan och upprepade meddelanden. Bekräfta att samma beställning återanvänds och att betalning genomförs en gång.
Dessa nedladdningar har käll- / gränssnittskontroller och simulerad kassavalidering. Full inbyggd butik installation och verklig betald utcheckning kräver fortfarande staging acceptans.
Förstå server-side betalning verifiering
Felsökning och nedladdningar
Om porten saknas, kontrollera den exakta butiksgrenenen, PHP, cache, inbyggd metod aktivering och kanalbegränsningar. Om en beställning förblir väntande, kontrollera referenser, aktiv prenumeration, plånböcker och allmänhetens uppringningsförmåga. Håll befintliga betalningsförsök vid uppdatering.