Cost+Docs

Shopware

Integrirajte Cost+ sa svojom Shopware 6 trgovinom koristeći službeni dodatak za plaćanje

Shopware

Integrirajte Cost+ kao način plaćanja u svojoj Shopware 6 trgovini. Službeni dodatak NoPayn Payment podržava više načina plaćanja po prodajnom kanalu i koristi hosted stranicu za plaćanje — potpuno usklađen s PCI DSS standardom.

Preduvjeti

  • Aktivan Cost+ trgovački račun
  • Shopware 6.7 ili noviji
  • PHP 8.2 ili noviji
  • SSH ili terminalni pristup vašem Shopware poslužitelju

Podržani načini plaćanja

Naziv na blagajniTehnički nazivNoPayn identifikator
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Svaki način se može omogućiti ili onemogućiti po prodajnom kanalu iz konfiguracije dodatka.

1. Instalirajte dodatak

Klonirajte ili kopirajte dodatak u svoj Shopware custom/plugins/ direktorij:

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

Zatim instalirajte i aktivirajte putem Shopware CLI-ja:

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

2. Konfigurirajte dodatak

  1. U Shopware administraciji idite na Settings → Extensions → NoPayn Payment
  2. Unesite svoj API ključ iz portala trgovca — idite na Websites, kliknite na web stranicu koju želite povezati, zatim kliknite Integration za pronalaženje API ključa
  3. Uključite ili isključite pojedine načine plaćanja
  4. Spremite

Cost+ portal trgovca s prikazom API ključa

Možete konfigurirati različit API ključ po prodajnom kanalu ako upravljate s više izloga.

Aktivirajte samo one načine plaćanja za koje ste odobreni i za koje ste primili potvrdu.

3. Tijek plaćanja

  1. Kupac odabire način plaćanja na blagajni i naručuje
  2. Narudžba se stvara sa statusom transakcije in_progress
  3. Kupac se preusmjerava na NoPayn hosted stranicu za plaćanje
  4. Nakon plaćanja:
    • Uspjeh — kupac se vraća, status se provjerava putem API-ja, transakcija postavljena na paid, narudžba postavljena na processing
    • Poništeno — kupac se vraća, transakcija i narudžba postavljeni na cancelled
    • Isteklo (vremensko ograničenje od 5 minuta) — webhook se aktivira, transakcija i narudžba postavljeni na cancelled

4. Mapiranje statusa narudžbe

NoPayn statusStanje transakcijeStanje narudžbe
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhookovi

Dodatak automatski registrira webhook krajnju točku na /api/nopayn/webhook. Ovaj URL šalje se NoPaynu prilikom stvaranja narudžbi, pružajući asinkronu potvrdu statusa za sve transakcije.

Ručna konfiguracija webhookova nije potrebna — dodatak automatski upravlja registracijom.

6. Testirajte i pokrenite

Napravite nekoliko testnih transakcija kako biste osigurali da sve radi glatko. Preporučujemo testiranje i uspješnih i neuspjelih plaćanja kako biste potvrdili da su svi scenariji pravilno obrađeni.

Podrška

Trebate pomoć? Obratite se našem timu za podršku na support@costplus.io.

On this page