Cost+Docs

Shopware

Integrujte Cost+ s vasim obchodom Shopware 6 pomocou oficialneho platobneho pluginu

Shopware

Integrujte Cost+ ako platobnu metodu vo vasom obchode Shopware 6. Oficialny plugin NoPayn Payment podporuje viacero platobnych metod na predajny kanal a pouziva proces hostovanej platobnej stranky -- plne kompatibilny s PCI DSS.

Predpoklady

  • Aktivny ucet obchodnika Cost+
  • Shopware 6.7 alebo novsi
  • PHP 8.2 alebo novsi
  • SSH alebo terminalovy pristup k vasmu serveru Shopware

Podporovane platobne metody

Nazov pri pokladniTechnicky nazovNoPayn identifikator
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Kazdu metodu je mozne aktivovat alebo deaktivovat pre kazdy predajny kanal z konfiguracii pluginu.

1. Instalacia pluginu

Klonujte alebo skopiujte plugin do adresara custom/plugins/ vasho Shopware:

cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment

Potom nainštalujte a aktivujte cez Shopware CLI:

bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear

2. Konfiguracia pluginu

  1. V administratorskom paneli Shopware prejdite na Settings -> Extensions -> NoPayn Payment
  2. Zadajte svoj API kluc z obchodneho portalu -- prejdite na Webove stranky, kliknite na webovu stranku, ktoru chcete pripojit, potom kliknite na Integracia, kde najdete vas API kluc
  3. Prepnite jednotlive platobne metody na aktivne alebo neaktivne
  4. Ulozte

Obchodny portal Cost+ zobrazujuci API kluc

Mozete nakonfigurovat odlisny API kluc pre kazdy predajny kanal, ak prevadzkujete viacero obchodov.

Aktivujte len tie platobne metody, pre ktore ste boli schvaleni a dostali potvrdenie.

3. Platobny proces

  1. Zakaznik si vyberie platobnu metodu pri pokladni a zada objednavku
  2. Objednavka sa vytvori so stavom transakcie in_progress
  3. Zakaznik je presmerovany na hostovanu platobnu stranku NoPayn
  4. Po platbe:
    • Uspech -- zakaznik sa vrati, stav sa overi cez API, transakcia sa nastavi na paid, objednavka na processing
    • Zrusenie -- zakaznik sa vrati, transakcia a objednavka sa nastavia na cancelled
    • Exspiracia (5-minutovy casovy limit) -- webhook sa spusti, transakcia a objednavka sa nastavia na cancelled

4. Mapovanie stavov objednavok

Stav NoPaynStav transakcieStav objednavky
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhooky

Plugin automaticky registruje webhook endpoint na /api/nopayn/webhook. Tato URL sa odosiela na NoPayn pri vytvarani objednavok, co poskytuje asynchronne potvrdenie stavu pre vsetky transakcie.

Ziadna manualna konfiguracia webhooku nie je potrebna -- plugin spracuvava registraciu automaticky.

6. Testovanie a spustenie

Vykonajte niekolko testovacich transakcii, aby ste sa uistili, ze vsetko funguje spravne. Odporucame testovat uspesne aj neuspesne platby na potvrdenie spravneho spracovania vsetkych scenarov.

Podpora

Potrebujete pomoc? Kontaktujte nas tym podpory na support@costplus.io.

On this page