Alla Integration Guides
LAGA PLUGIN · PÅ SITE + HPPTa emot kryptobetalningar med osCommerce 4.14
Native V4 betalningsmodul; separat från legacy osCommerce 2.x och 3.x.
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 |
|---|
| osCommerce 4.14.x; infödd V4 orderBetalningsmodul API | PHP 7.4.x-8.3.x, med förbehåll för den installerade osCommerce release och beroende lås |
|---|
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
- Tillbaka upp butiken, sedan kopiera ZIP: s lib mapp i osCommerce 4 applikation rot, bevara katalogen hierarki.
- I admin betalningsmodulerna, installera MochiPay för den erforderliga plattformen och öppna dess inställningar. Ange referenser och aktivera det.
- Välj den inhemska betalda orderstatus om det behövs. Value 0 använder plattformsstandarden; betalningsredovisning lagras i den ursprungliga ordersPayment ledger.
- Håll callback/webhooks.payment.mochipay offentligt. Behåll den genererade callback-adressen och dess försökstoken. Denna modul täcker endast hela order.
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.