Cost+Docs

PrestaShop

Integrujte Cost+ s vasim obchodom PrestaShop (9.x, 8.x, 1.7 a 1.6)

PrestaShop

Integrujte Cost+ ako platobnu metodu vo vasom obchode PrestaShop. Modul Cost+ je dostupny pre PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 a PrestaShop 1.6.1.x.

Predpoklady

  • Aktivny ucet obchodnika Cost+
  • PrestaShop 9.1 alebo novsi
  • PHP 8.1 alebo novsi
  • SSL/HTTPS aktivovane
  • Administratorsky pristup k vasmu PrestaShop back office
  • Aktivny ucet obchodnika Cost+
  • Instalacia PrestaShop 8.x
  • PHP 8.0 alebo novsi
  • Administratorsky pristup k vasmu PrestaShop back office
  • MySQL 5.4 alebo vyssi
  • Aktivny ucet obchodnika Cost+
  • Instalacia PrestaShop 1.7.x
  • PHP 5.4 alebo novsi
  • Administratorsky pristup k vasmu PrestaShop back office
  • MySQL 5.4 alebo vyssi
  • Aktivny ucet obchodnika Cost+
  • Instalacia PrestaShop 1.6.1.x
  • PHP 5.6 alebo novsi (s rozsireniami cURL a OpenSSL)
  • SSL/HTTPS aktivovane v obchode
  • Administratorsky pristup k vasmu PrestaShop back office

1. Instalacia modulu

Stiahnite modul z GitHub.

Metoda A: Nahratie cez administratorsky panel (odporucane)

  1. Prejdite na Modules -> Module Manager v administratorskom paneli
  2. Kliknite na Upload a module
  3. Pretiahnite ZIP subor alebo ho vyberte manualne
  4. Pockajte na dokoncenie instalacie
  5. Vyhladajte "NoPayn" a kliknite na Configure

Metoda B: Manualne nahratie

  1. Skopiujte priecinok nopaynpayment/ do adresara modules/ vasho PrestaShop
  2. Prejdite na Modules -> Module Manager
  3. Vyhladajte "NoPayn" a kliknite na Install
  4. Kliknite na Configure na otvorenie nastaveni

Stiahnite modul z GitHub.

Metoda A: Nahratie cez administratorsky panel (odporucane)

  1. Prejdite na Improve > Module Manager v administratorskom paneli
  2. Kliknite na Upload a module
  3. Pretiahnite ZIP subor alebo ho vyberte manualne
  4. Pockajte na dokoncenie instalacie
  5. Posunte nadol do sekcie "Other" a kliknite na Configure pod Cost+

PrestaShop 8 Module Manager

Dialog nahratia modulu

Metoda B: Manualne nahratie cez (S)FTP

  1. Rozbalte stiahnuty ZIP subor
  2. Pomocou SFTP klienta (napr. FileZilla, WinSCP) nahrante vsetky priecinky do adresara /modules/ vasej instalacie PrestaShop
  3. Prejdite na Improve > Modules > Module Catalog
  4. Vyhladajte "Cost+" -- skontrolujte kartu Uninstalled Modules, ak je to potrebne
  5. Kliknite na Install

Stiahnite modul z GitHub.

Metoda A: Nahratie cez administratorsky panel (odporucane)

  1. Prejdite na Improve > Module Manager v administratorskom paneli
  2. Kliknite na Upload a module
  3. Pretiahnite ZIP subor alebo ho vyberte manualne
  4. Pockajte na dokoncenie instalacie
  5. Posunte nadol do sekcie "Other" a kliknite na Configure pod Cost+

PrestaShop 1.7 Module Manager

Dialog nahratia modulu

Metoda B: Manualne nahratie cez (S)FTP

  1. Rozbalte stiahnuty ZIP subor
  2. Pomocou SFTP klienta (napr. FileZilla, WinSCP) nahrante vsetky priecinky do adresara /modules/ vasej instalacie PrestaShop
  3. Prejdite na Modules > Module Manager
  4. Vyhladajte "Cost+" -- skontrolujte kartu Uninstalled Modules, ak je to potrebne
  5. Kliknite na Install

Stiahnite modul z GitHub.

Metoda A: Nahratie cez administratorsky panel (odporucane)

  1. Stiahnite costpluspayment.zip zo stranky GitHub Releases
  2. Prejdite na Modules and Services v PrestaShop back office
  3. Kliknite na Add a new module
  4. Nahrante ZIP subor
  5. Vyhladajte Cost+ Payment Gateway v zozname modulov a kliknite na Install

Metoda B: Manualne nahratie cez (S)FTP

  1. Rozbalte stiahnuty ZIP subor
  2. Pomocou SFTP klienta nahrajte priecinok costpluspayment/ do /modules/costpluspayment/ vo vasej PrestaShop instalacii
  3. Prejdite na Modules and Services v back office
  4. Vyhladajte Cost+ Payment Gateway a kliknite na Install

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 konfiguracii modulu NoPayn zadajte svoj API kluc a nakonfigurujte nasledujuce nastavenia:

NastaveniePopis
API KeyVas NoPayn API kluc
Credit / Debit CardAktivacia/deaktivacia platieb kartou
Apple PayAktivacia/deaktivacia Apple Pay
Google PayAktivacia/deaktivacia Google Pay
Vipps MobilePayAktivacia/deaktivacia Vipps MobilePay
Manual CaptureAutorizacia platieb kartou bez okamziteho zachytenia -- zachytenie pri odoslani
Debug LoggingAktivacia podrobneho logovania do var/logs/nopayn_debug.log

Vlozte kluc do pola API Key na konfiguracnej stranke kniznice Cost+ a kliknite na Save.

Konfiguracna stranka Cost+ v PrestaShop 8

Vlozte kluc do pola API Key na konfiguracnej stranke kniznice Cost+ a kliknite na Save.

Konfiguracna stranka Cost+ v PrestaShop 1.7

Po instalacii kliknite na Configure v module Cost+ Payment Gateway a nastavte nasledujuce:

NastaveniePopis
API KeyVas Cost+ API kluc z obchodneho portalu
Credit / Debit CardAktivacia/deaktivacia platieb kartou
Apple PayAktivacia/deaktivacia Apple Pay
Google PayAktivacia/deaktivacia Google Pay
Vipps MobilePayAktivacia/deaktivacia Vipps MobilePay
Manual CaptureAutorizacia platieb kartou -- zachytenie pri odoslani
Checkout ExpiryCasovy limit cakajucej objednavky v minutach (predvolene 5)
Debug LoggingAktivacia podrobneho logovania do log/costplus_debug.log

Po ulozeni otvorte Payment > Restrictions a aktivujte modul Cost+ Payment Gateway pre kazdu menu, ktoru prijimate.

Pre hostovacie prostredia PrestaShop 8.x, 1.7 a 1.6 aktivujte moznost cURL CA bundle pocas konfiguracii, aby ste predisli problemom s SSL certifikatmi.

3. Aktivacia platobnych metod

Platobne metody sa konfiguruju priamo v nastaveniach modulu (pozrite krok 2 vyssie). Prepnite kazdu metodu podla potreby.

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

Po ulozeni vasho API kluca nahrante kazdy modul platobnej metody samostatne cez Upload a module.

Vratte sa do Improve > Module Manager, kliknite znova na Upload a module a nahrante kazdy ZIP subor pre platobne metody, ktore chcete aktivovat (napr. Credit Card, MobilePay, Swish).

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

Platobne moduly budu mat bud moznost Configure (ak je potrebne dodatocne nastavenie), alebo len prepinac Aktivacia/Deaktivacia.

Po ulozeni vasho API kluca nahrante kazdy modul platobnej metody samostatne cez Upload a module.

Vratte sa do Improve > Module Manager, kliknite znova na Upload a module a nahrante kazdy ZIP subor pre platobne metody, ktore chcete aktivovat (napr. Credit Card, MobilePay, Swish).

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

Platobne moduly budu mat bud moznost Configure (ak je potrebne dodatocne nastavenie), alebo len prepinac Aktivacia/Deaktivacia.

Platobne metody sa prepinaju priamo na konfiguracnej stranke modulu (pozrite krok 2 vyssie). Aktivujte kazdu metodu, ktoru chcete mat dostupnu pri pokladni.

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 Cost+ (HPP)
  3. Po dokonceni platby je zakaznik presmerovany spat do obchodu
  4. Webhook potvrdi stav platby server-to-server

Webhook

Webhook URL je automaticky nakonfigurovana pre kazdu objednavku:

https://your-shop.com/module/nopaynpayment/webhook

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

Manualne zachytenie

Ked je aktivovane pre platby kartou:

  • Platba je autorizovana, ale nie zachytena pri pokladni
  • Zachytenie nastane, ked je objednavka odoslana / oznacena ako dokoncena
  • Ak je objednavka zrusena, autorizacia je automaticky anUlovana

Automaticke vratenie

Ak je objednavka so zachytenou platbou zrusena, modul automaticky vyda uplne vratenie. Ciastocne vratenia je mozne spracovat cez kreditne dobropis PrestaShop.

Popisky tlacidiel pokladne

Pre najlepsi zaziatok s procesmi presmerovania mimo stranku zvazite aktualizaciu popisku tlacidla pokladne na "Skontrolovat objednavku" namiesto "Potvrdit a zaplatit", pretoze skutocna platba prebieha na hostovanej stranke Cost+. Toto je globalne nastavenie PrestaShop, nie specificke pre modul.

Webhook

Webhook je automaticky nakonfigurovany modulom. Ziadne manualne nastavenie nie je potrebne.

Webhook

Webhook je automaticky nakonfigurovany modulom. Ziadne manualne nastavenie nie je potrebne.

Webhook

Konfiguracna stranka modulu zobrazuje URL webhooku. Skopirujte ju do svojho Cost+ dashboardu ak vas Cost+ ucet vyzaduje staticku registraciu webhooku.

Endpoint webhooku prijima udalosti Cost+, potom znovu vola Cost+ pomocou GET /orders/{id} pred aktualizaciou objednavky PrestaShop -- vdaka tomu je spracovanie navratovej URL a webhooku idempotentne.

Cron pre vyprsenie

Konfiguracna stranka modulu zobrazuje URL cronu pre vyprsenie. Naplanujte ho, aby bezal kazdu minutu:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Pouzite presnu URL zobrazenu vo vasom PrestaShop back office -- token sa generuje pocas instalacie a je iny pre kazdy obchod. Endpoint cronu zrusi zastarane cakajuce objednavky Cost+ po nakonfigurovanom Checkout Expiry.

Manualne zachytenie a vratenia

  • Ked je aktivovane Manual Capture, platby su pri pokladni autorizovane a zachytene, ked je objednavka odoslana / oznacena ako dokoncena
  • Ak je zachytena objednavka zrusena, modul automaticky vyda uplne vratenie
  • Ciastocne vratenia su spracovavane cez kreditne dobropis PrestaShop

4. Zaverecne kroky a testovanie

  1. Skontrolujte vsetky aktivovane platobne metody
  2. Vykonajte niekolko testovacich transakcii -- uspesnych aj neuspesnych -- aby ste sa uistili, ze vsetko prebieha hladko
  3. Nakonfigurujte pokrocile spravanie ako manualne vs. automaticke zachytenie v zavislosti od vasho procesu plnenia

Podpora

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

On this page