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

Vastaanota kryptomaksuja Shopware 6.6 / 6.7-alustalla

Shopware 6.6 ja 6.7.

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
Shopware >=6.6.10.0 <6.7.0.0PHP 8.2.x / 8.3.x / 8.4.x
Shopware >=6.7.0.0 <6.8.0.0PHP 8.2.x / 8.3.x / 8.4.x

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. Asenna vain Shopware-haaran ZIP. Lataa se laajennusten alla > Laajennukset, tai poimia MochiPay mukautetun / plugins / MochiPay. Älä asenna molempia pakkauksia.
  2. From the store root run bin/console plugin:refresh, sitten bin/console plugin: install --aktivate MochiPay.
  3. Määrittele tunnusmerkit ja mahdollista laajennus jokaiselle myyntikanavalle, joka käyttää sitä. Käytä sen maksutapaa Asetukset > Maksutavat ja määrittää myyntikanavat.
  4. Kun päivittää Shopware 6.6-6.7, varmuuskopioida asetukset ja maksuhistoria, korvata plugin tiedostot 6.7 paketti, sitten ajaa normaali plugin: Päivitä MochiPay prosessi.

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.