Alla Integration Guides
LAGA PLUGIN · PÅ SITE + HPPTa emot kryptobetalningar med Sylius 2.0
Native Payum checkout och Sylius betalning statliga maskin.
Nya adaptrar är initial integration bygger. Komplett installation och betalningsacceptans i din egen staging butik innan du aktiverar levande trafik.
Välj rätt paket- och PHP-miljö
| Shopping plattform | PHP miljö för detta paket |
|---|
| Sylius >=2.0.0 <2.1.0 med PayumBundle 2.6+ / Payum 1.7-kompatibel kärna | PHP 8.2.x/8.3.x/8.4.x (tillfredsställer även butikens beroendelås) |
|---|
Använd PHP-versionen tillåten av både detta paket och din exakta kärnutgåva. En plugin gör inte en äldre butik kärna kompatibel med nyare PHP.
Nya paket använder valfri request_id-deduplicering och kräver MochiPay Web65 eller senare. Befintliga kunder kan behålla sina nuvarande plugins och API-integrationer.
01 · Förbered ditt MochiPay-konto
- Skapa ett konto · aktivera ett abonnemang.
- Plånböcker Möjliggöra en mottagande plånbok för varje tillgång/nätverk du kommer att erbjuda. Tillbaka upp återställningsmaterial före kassan.
- API-uppgifter Håll köpmannen API-nyckeln och hemligheten på servern. Placera aldrig referenser i kassan HTML eller webbläsarskript.
02 · Installera och aktivera den inhemska porten
- Extrahera MochiPaySylius i plugins/MochiPaySylius. Lägg till en lokal kompositörbana och kör kompositör kräver mochipay/sylius-plugin:1.0.0.0.
- Registrera MochiPay\Sylius\MochiPayBundle i config/bundles.php, och importera sina rutter som beskrivs i README.md inuti ZIP.
- Kör bin / konsol cache:clear och bin / konsol mochipay:install. Befintliga betalningsförsök bevaras.
- Skapa en infödd betalningsmetod med MochiPay gateway fabrik. Ange referenser, aktivera MochiPay och den inhemska metoden och tilldela kanaler.
- Använd Sylius 2.0 Payum-kassan. MySQL/MariaDB och PostgreSQL stöds; Sylius 1.x och 2.1+ kräver olika adaptrar.
Den engelska README inuti varje ZIP innehåller exakta vägar, inhemsk konfiguration, beroenden och uppgradera anteckningar. Följ den för din plattform.
04 · ON_SITE och HPP använder samma betalning
ON_SITEBetalningsdialog i din butik
Standarddialogrutan ON_SITE visar exakt belopp, adress, nätverk, QR och betalningsstatus på din butiksdomän.
HPPMochiPay värd betalningssida
HPP öppnar MochiPay payment_url och återvänder till din butik efter kassan. Välj HPP i samma gatewayinställningar.
Om du öppnar kassan igen eller byter presentation återanvänds den sparade betalningsordern. Ingen payment_mode-parameter läggs till i MochiPay API.
Prova den offentliga ON_SITE/HPP-simuleringen →
05 · Verifiera en staging order innan du går live
- Placera en liten staging order. Bekräfta fiat totalt, vald tillgång, nätverk och exakt kryptobelopp innan du skickar betalning.
- Kontrollera att servern frågar MochiPay och registrerar det ursprungliga betalda tillståndet först efter ett matchat PAID-resultat. En retur URL eller callback kropp ensam är inte betalningsbevis.
- Testa HPP, ON_SITE, återöppning av kassan och upprepade meddelanden. Bekräfta att samma beställning återanvänds och att betalning genomförs en gång.
Dessa nedladdningar har käll- / gränssnittskontroller och simulerad kassavalidering. Full inbyggd butik installation och verklig betald utcheckning kräver fortfarande staging acceptans.
Förstå server-side betalning verifiering
Felsökning och nedladdningar
Om porten saknas, kontrollera den exakta butiksgrenenen, PHP, cache, inbyggd metod aktivering och kanalbegränsningar. Om en beställning förblir väntande, kontrollera referenser, aktiv prenumeration, plånböcker och allmänhetens uppringningsförmåga. Håll befintliga betalningsförsök vid uppdatering.