Cost+Docs

OpenCart

Integrujte Cost+ s vasim obchodom OpenCart (4.x a 3.x / ocStore 3)

OpenCart

Integrujte Cost+ ako platobnu metodu vo vasom obchode OpenCart. Oficialne rozsirenie NoPayn Payment Gateway je dostupne pre OpenCart 4 a OpenCart 3 / ocStore 3.

Predpoklady

  • Aktivny ucet obchodnika Cost+
  • OpenCart 4.0.0.0 alebo novsi
  • PHP 8.0 alebo novsi
  • Administratorsky pristup k vasmu dashboardu OpenCart
  • Aktivny ucet obchodnika Cost+
  • ocStore 3.0.x alebo OpenCart 3.0.3.x
  • PHP 7.4 alebo novsi
  • Administratorsky pristup k vasmu dashboardu OpenCart

Podporovane platobne metody

  • Credit / Debit Card -- Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Credit / Debit Card -- Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Instalacia rozsirenia

Metoda A: Nahratie cez administratorsky panel (odporucane)

  1. Stiahnite najnovsie vydanie .ocmod.zip z GitHub
  2. V administratorskom paneli OpenCart prejdite na Extensions -> Installer
  3. Nahrante subor .ocmod.zip
  4. Prejdite na Extensions -> Extensions -> Payment
  5. Najdite NoPayn Payment Gateway a kliknite na Install, potom Edit

Metoda B: Manualne nahratie

  1. Stiahnite alebo klonujte repozitar
  2. Skopiujte obsah priecinku upload/ do korenovoho adresara vasho OpenCart
  3. Prejdite na Extensions -> Extensions -> Payment
  4. Najdite NoPayn Payment Gateway a kliknite na Install, potom Edit

Architektura

OpenCart 3 pouziva viac-rozsireniovy setup:

  • NoPayn - Global Settings -- zdielana konfiguracia (API kluc, stavy objednavok, dostupnost metod, manualne zachytenie, ladiace logovanie)
  • NoPayn - Card Payments -- pokladna pre kreditne/debetne karty
  • NoPayn - Apple Pay / Google Pay -- pokladna pre penazenkove platby (ak je aktivovana len jedna penazenka, popisok sa automaticky prisposobi)
  • NoPayn - Vipps MobilePay -- pokladna pre Vipps/MobilePay
  • NoPayn - Swish -- pokladna pre Swish

Metoda A: Nahratie cez administratorsky panel (odporucane)

  1. Stiahnite .ocmod.zip subor z najnovsieho GitHub vydania

Pouzite .ocmod.zip subor z vydania -- nie automaticky generovane "Source code" stahovania z GitHub, ktore obsahuju rozlozenie repozitara, nie rozlozenie instalacieneho programu.

  1. V administratorskom paneli prejdite na Extensions -> Installer
  2. Nahrante subor .ocmod.zip
  3. Prejdite na Extensions -> Extensions -> Payments
  4. Najprv nainštalujte NoPayn - Global Settings
  5. Otvorte NoPayn - Global Settings a nakonfigurujte:
    • API kluc
    • Stavy dokoncených, cakajucich a zrusenych objednavok
    • Dostupne platobne metody schvalene pre vas obchodnicky ucet
    • Volitelne: manualne zachytenie kariet
    • Volitelne: ladiace logovanie
  6. Nainštalujte moduly pokladne, ktore chcete zobrazit:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Pre kazdy modul pokladne nastavte: Status, Geo Zone a Sort Order

Metoda B: Manualne nahratie

  1. Stiahnite alebo klonujte repozitar
  2. Skopiujte obsah priecinku upload/ do korena vasho obchodu
  3. Prejdite na Extensions -> Extensions -> Payments
  4. Postupujte podla rovnakeho poradia instalacie ako v Metode A (najprv Global Settings, potom moduly pokladne)

2. Zadanie API prihlaseni

Prihlaste sa do obchodneho portalu a prejdite na Webove stranky, potom kliknite na webovu stranku, ktoru chcete pripojit. Kliknite na Integracia, kde najdete svoj API kluc.

Obchodny portal Cost+ zobrazujuci API kluc

V nastaveniach NoPayn Payment Gateway zadajte svoj API kluc do prislusneho pola.

V NoPayn - Global Settings zadajte svoj API kluc do prislusneho pola. API kluc je zdielany medzi vsetkymi modulmi pokladne -- staci ho zadat raz.

3. Konfiguracia nastaveni platieb

  1. Aktivujte platobne metody, pre ktore ste boli schvaleni
  2. Nastavte preferovane stavy objednavok pre dokoncene, cakajuce a zrusene platby
  3. Volitelne obmedzte platby podla Geo Zone
  4. Nastavte Status na Enabled
  5. Kliknite na Save

Globalne nastavenia

NoPayn - Global Settings uklada vsetku zdielanu konfiguraciu:

NastaveniePopis
API KeyVas NoPayn API kluc
Order StatusesMapovanie stavov dokoncených, cakajucich a zrusenych objednavok
Method AvailabilityKtore platobne metody su schvalene pre vas obchodnicky ucet
Manual CaptureAutorizacia platieb kartou bez okamziteho zachytenia -- zachytenie neskor
Debug LoggingAktivacia podrobneho logovania na riesenie problemov

Nastavenia modulov pokladne

Kazdy modul pokladne ma vlastne nastavenia pre predajnu:

NastaveniePopis
StatusAktivacia alebo deaktivacia tejto platobnej metody pri pokladni
Geo ZoneObmedzenie na konkretne geograficke zony
Sort OrderPoradie zobrazenia na stranke pokladne

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

Platobny proces

  1. Zakaznik si vyberie platobnu metodu Cost+ pri pokladni
  2. Zakaznik je presmerovany na hostovanu platobnu stranku NoPayn
  3. Po platbe sa zakaznik vrati a stav objednavky sa automaticky aktualizuje
  4. NoPayn posle webhook pre asynchronne potvrdenie stavu

Rozsirenie pouziva hostovanu platobnu stranku Cost+, co znamena, ze zakaznici su presmerovani na bezpecny platobny formular. Ziadne citlive udaje kariet sa nespracuvavaju na vasom serveri.

Kazdy modul pokladne je samostatne platobne rozsirenie OpenCart, co dava zakaznikom odlisne radio moznosti pri pokladni (napr. "Card Payments", "Apple Pay & Google Pay").

  1. Zakaznik si vyberie popisok platobnej metody pri pokladni (napr. Card Payments)
  2. Rozsirenie vytvori hostovanu platobnu objednavku NoPayn
  3. Zakaznik je presmerovany na bezpecnu platobnu stranku NoPayn
  4. Po platbe sa zakaznik vrati a stav objednavky sa automaticky aktualizuje
  5. NoPayn posle webhook pre asynchronne potvrdenie stavu

Modul Apple Pay / Google Pay posle obe metody v jednej transakcii, takze hostovana stranka NoPayn moze ponuknut obe moznosti penazenky v jednom procese.

Aktualizacia z v1.0.0 na v2.0.0

Verzia 1.0.0 pouzivala jednu metodu pokladne s nazvom "NoPayn Checkout". Verzia 2.0.0 meni na samostatne moduly pokladne podla platobnej metody. Pri aktualizacii:

  1. Nahrante novy balik
  2. Vasa existujuca polozka "NoPayn Checkout" sa stane NoPayn - Global Settings
  3. Skontrolujte a ulozte globalne nastavenia
  4. Nainštalujte a aktivujte nove moduly pokladne, ktore chcete zakaznikom zobrazit

4. 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