‡ Alle integrationsvejledninger
BUTIKSUDVIDELSE · ON-SITE + HPP

Modtag kryptobetalinger med Drupal Commerce

Native Commerce betalingsgateway for de støttede Drupal og Commerce filialer.

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
Handel 2.40.x med Drupal 9.3-10.x; eller handel 3.3.10 + < 3.4 med Drupal 10.3-11.xDrupal 9.3-9.5: PHP 7.4-8.1; Drupal 10: PHP 8.1-8.3; Drupal 11: PHP 8.3-8.4, kun når det er tilladt ved den nøjagtige Drupal frigivelse

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. Uddrag mochipay i web / moduler / custom / mochipay, eller moduler / custom / mochipay når dit projekt root er dokumentet rod.
  2. Kør drush en mochipay - y, derefter drush cr. Installationen bevarer eksisterende betalingsforsøg opbevaring.
  3. I Handel > Konfiguration > Betalingsgateways skal du oprette en MochiPay-gateway. Hold native gateway-tilstand Live; denne indstilling er uafhængig af ON_SITE/HPP.
  4. Aktivér både gateway-enheden og Aktivér MochiPay, indtast legitimation og gem. Holde / mochipay / checkout / {gateway- machine- name} offentlig og uncachet.

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.