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

Vastaanota kryptomaksuja Bagisto 2.3-alustalla

Laravel paketti natiivi tilauksia ja laskun käsittely.

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
Bagisto >=2.3.0 <2.4.0PHP 8.2.x / 8.3.x / 8.4.x (täytä myös varaston huoltolukko)

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. Pura MochiPay pakkauksiin/MochiPay. Lisää paikallinen Säveltäjän polkuvarasto tälle kansiolle säilyttäen samalla olemassa olevat arkistot.
  2. Suorita säveltäjä vaatii mochipay / bagisto-maksu:1.0.0, php artisan migrate --force ja php artisan optimointi:clear.
  3. Avaa asetukset > Myynti > Maksutavat > MochiPay. Syötä tiedot, ota menetelmä käyttöön, valitse määrä suunta ja tallenna.
  4. Käytä MySQL/MariaDB:tä. Laravel pakettihaku rekisteröi palveluntarjoajan; jos löytö on pois päältä, noudata palveluntarjoajan ohjeita ZIP:n sisällä.

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.