← Kaikki integraatio-oppaat
PLUGIN · ON-SITE + HPP

Vastaanota kryptomaksuja osCommerce 4.14-alustalla

Native V4 maksumoduuli; erillinen vanha osCommerce 2.x ja 3.x.

Uudet adapterit ovat alkuperäisiä integraatiorakennuksia. Täydellinen asennus ja todellinen maksu hyväksyminen omassa pysähdysmyymälässä ennen mahdollistamista elävän liikenteen.

Valitse oikea paketti ja PHP-ympäristö

KauppapaikkaPHP ympäristö tälle paketille
osCommerce 4.14.x; natiivi V4 tilausMaksumoduuli APIPHP 7.4.x–8.3.x, edellyttäen, että asennettu osCommerce-vapautus- ja riippuvuuslukko

Käytä PHP versiota, jonka sekä tämä paketti että tarkka ydinjulkaisu. Plugin ei tee vanhempi myymälän ydin yhteensopiva uudempi PHP.

Uudet paketit käyttävät valinnaista request_id duplikoinnin poistoa ja vaativat MochiPay Web65 tai uudemman. Nykyiset asiakkaat voivat säilyttää nykyiset lisäosat ja API-integraatiot.

01 · Valmistele MochiPay tili

  1. Luo tili · aktivoi tilaus.
  2. Lompakot · Ota käyttöön vastaanottava lompakko jokaiselle tarjoamasi omaisuudelle/verkolle. Varmuuskopioi palautusmateriaali ennen kassalle siirtymistä.
  3. API-valtuutukset · Pidä kauppias API avain ja salaisuus palvelimella. Älä koskaan laita tietoja kassalle HTML- tai selainskripteihin.

02 · Asenna ja mahdollista natiivi yhdyskäytävä

  1. Tallenna tallentaa, sitten kopioida ZIP lib kansio osaksi osCommerce 4 sovelluksen juuri, säilyttäen hakemistohierarkia.
  2. Vuonna admin maksu moduulit, asentaa MochiPay vaaditun alustan ja avata sen asetukset. Syötä tiedot ja salli se.
  3. Valitse tarvittaessa maksullinen tila. Arvo 0 käyttää alustan oletusta; maksukirjanpito tallennetaan alkuperäiseen TilauksetPayment tilikirjaan.
  4. Pidä puhelu / webkooks.payment.mochipay julkinen. Säilytä luotu Callback URL ja sen yritys merkki. Tämä moduuli kattaa vain kokonaiset tilaukset.

Englanti README sisällä kunkin ZIP sisältää tarkat polut, natiivi kokoonpano, riippuvuuksia ja päivitys muistiinpanoja. Seuraa sitä alustalle.

03 · Tarkastele valmiita oletusarvoja

AsetuksetOletusarvo
MochiPay URLhttps://mochi.bz
MaksutapaON_SITE
Ainutlaatuinen määräsuuntaUP
Valitut valuutat ja verkotUSDT/TRC20 · USDC/ERC20 · BTC/Bitcoin · ETH/Ethereum · SOL/Solana
Portti käytössä-Ei, kunnes lompakot ovat valmiina.

Syötä API-kirjautumistietosi, valitse YLÖS tai ALAS kohtaan Yksilöllinen summa, ota MochiPay käyttöön ja tallenna. ON_SITE ja kaikki kuusi menetelmää on esivalittu; tarjoavat vain menetelmiä, joissa on aktiivinen vastaanottava lompakko. Natiivimaksutapa ja kanava-asetukset ovat edelleen voimassa.

04 · ON_SITE ja HPP käyttävät samaa maksua

ON_SITE

Maksuikkuna myymälässäsi

Oletusarvoinen ON_SITE-valintaikkuna näyttää tarkan summan, osoitteen, verkon, QR-koodin ja maksutilan myymäläsi verkkotunnuksessa.

HPP

MochiPay isännöi maksusivu

HPP avaa MochiPay payment_url ja palaa myymälään kassan jälkeen. Valitse HPP samoissa yhdyskäytävän asetuksissa.

Kassan uudelleen avaaminen tai esityksen vaihtaminen käyttää tallennetun maksumääräyksen uudelleen. Parametria payment_mode ei lisätä parametriin MochiPay API.

Kokeile julkista ON_SITE/HPP-simulaatiota →

05 · Varmistetaan vaihejärjestys ennen lähetystä

  1. Tee pieni välikäsky. Vahvista fiat yhteensä, valittu omaisuuserä, verkko ja tarkka crypto määrä ennen maksun lähettämistä.
  2. Varmista, että palvelin kyselyt MochiPay ja tallentaa syntyperäinen maksettu valtio vasta sen jälkeen, kun sovitettu PAID tulos. Paluu URL tai Callback elin yksin ei ole maksu todiste.
  3. Testaa HPP, ON_SITE, kassan avaaminen uudelleen ja toistuvat ilmoitukset. Varmista, että samaa tilausta käytetään uudelleen ja maksu suoritetaan kerran.

Näillä latauksilla on lähde/yhteystarkistus ja simuloitu kassan validointi. Täysi natiivi-myymälä asennus ja todellinen maksettu kassalle vielä vaativat vaihe hyväksyntä.

Ymmärrä palvelimen puolella maksun tarkistus →

Vianmääritys ja lataukset

Jos yhdyskäytävä puuttuu, tarkista tarkka varastohaara, PHP, välimuisti, natiivi menetelmä aktivointi ja kanavan rajoitukset. Jos tilaus on vielä kesken, tarkista tunnukset, aktiivinen tilaus, lompakot ja julkinen soittomahdollisuus. Pidä olemassa olevat maksuyritykset ajan tasalla.