‡ Alle integrationsvejledninger
BUTIKSUDVIDELSE · ON-SITE + HPP

Modtag kryptobetalinger med osCommerce 4.14

Indfødt V4 betalingsmodul; adskilt fra arv osCommerce 2.x og 3.x.

Nye adaptere er indledende integration bygger. Komplet installation og realbetaling accept i din egen iscenesættelse butik, før du aktiverer levende trafik.

Vælg den korrekte pakke og PHP miljø

ShoppingplatformPHP miljø til denne pakke
osCommerce 4.14.x; native V4 orderPayment modul APIPHP 7.4.x- 8.3.x, med forbehold af den installerede osCommerce frigivelse og afhængighedslås

Brug PHP version tilladt af både denne pakke og din nøjagtige kerne udgivelse. Et plugin gør ikke en ældre butik kerne kompatibel med nyere PHP.

Nye pakker bruger valgfri request_id deduplikering og kræver MochiPay Web65 eller nyere. Eksisterende kunder kan beholde deres nuværende plugins og API integrationer.

01 · Forbered din MochiPay-konto

  1. Opret en konto · aktivere et abonnement.
  2. Tegnebøger · Aktivér en modtagende tegnebog for hvert aktiv / netværk du vil tilbyde. Sikkerhedskopiér materiale før udtjekning.
  3. API-afstemning · Hold købmand API nøgle og hemmelighed på serveren. Aldrig sætte legitimation i checkout HTML eller browser scripts.

02 · Installere og aktivere den indfødte gateway

  1. Sikkerhedskopiere butikken, derefter kopiere ZIP "s lib mappe i osCommerce 4 ansøgning root, bevare mappen hierarki.
  2. I admin betalingsmoduler, installere MochiPay for den nødvendige platform og åbne sine indstillinger. Indtast legitimation og aktivere det.
  3. Vælg den indfødte Betalt ordrestatus hvis det er nødvendigt. Værdi 0 bruger platform standard; betaling regnskab gemmes i den indfødte OrdersPayment hovedbog.
  4. Hold callback / webhooks.payment.mochipay offentlig. Behold den genererede callback URL og dens forsøg token. Dette modul dækker kun hele ordrer.

Den engelske README inde i hver ZIP omfatter de nøjagtige stier, indfødte konfiguration, afhængigheder og opgradering noter. Følg den for din platform.

03 · Gennemgå ready- made default

IndstillingStandardværdi
MochiPay URLhttps://mochi.bz
BetalingsmådeON_SITE
Entydigt beløb retningUP
Udvalgte valutaer og netværkUSDT/TRC20 · USDC/ERC20 · BTC/Bitcoin · ETH/Ethereum · SOL/Solana
Gateway aktiveretDeaktiveret indtil legitimation og modtagelse tegnebøger er klar.

Indtast dine API legitimationsoplysninger, vælg OP eller NED for Unik mængde retning, aktiver MochiPay og gem. ON_SITE og alle seks metoder er forudvalgt; tilbyder kun metoder med en aktiv modtagende tegnebog. Indstillinger for indbygget betalingsmetode og kanal gælder stadig.

04 · ON_SITE og HPP bruger samme betaling

ON_SITE

Betalingsdialog i din butik

Standard ON_SITE-dialogen viser det nøjagtige beløb, adresse, netværk, QR og betalingsstatus på dit butiksdomæne.

HPP

MochiPay hostede betalings side

HPP åbner MochiPay payment_url og vender tilbage til din butik efter kassen. Vælg HPP i de samme gateway-indstillinger.

Genåbning af kassen eller skift af præsentation genbruger den gemte betalingsordre. Ingen payment_mode-parameter er tilføjet til MochiPay API.

Prøv den offentlige ON_SITE/HPP-simulering →

05 · Verificér en iscenesættelse før du går live

  1. Placer en lille iscenesættelse ordre. Bekræft fiat samlede, valgte aktiv, netværk og nøjagtige crypto beløb, før du sender betaling.
  2. Verificér, at serveren spørger MochiPay og registrerer den indfødte betalte stat kun efter en matchende PAID resultat. En tilbagevenden URL eller callback organ alene er ikke betalingsbevis.
  3. Test HPP, ON_SITE, genåbning af kassen og gentagne meddelelser. Bekræft, at den samme ordre genbruges, og at betaling gennemføres én gang.

Disse downloads har kilde-/grænsefladetjek og simuleret checkout-validering. Fuld indbygget butiksinstallation og ægte betalt betaling kræver stadig iscenesættelsesaccept.

Forstå serverside betaling verifikation →

Fejlfinding og downloads

Hvis gateway mangler, skal du kontrollere den nøjagtige butik gren, PHP, cache, native metode aktivering og kanal begrænsninger. Hvis en ordre stadig er under behandling, skal du kontrollere legitimation, aktivt abonnement, tegnebøger og offentlig callback adgang. Behold eksisterende betalingsforsøg, når du opdaterer.