Cost+Docs

PrestaShop

Integrirajte Cost+ sa svojom PrestaShop trgovinom (9.x, 8.x, 1.7 i 1.6)

PrestaShop

Integrirajte Cost+ kao način plaćanja u svojoj PrestaShop trgovini. Cost+ modul dostupan je za PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 i PrestaShop 1.6.1.x.

Preduvjeti

  • Aktivan Cost+ trgovački račun
  • PrestaShop 9.1 ili noviji
  • PHP 8.1 ili noviji
  • SSL/HTTPS omogućen
  • Administratorski pristup vašem PrestaShop back officeu
  • Aktivan Cost+ trgovački račun
  • PrestaShop 8.x instalacija
  • PHP 8.0 ili noviji
  • Administratorski pristup vašem PrestaShop back officeu
  • MySQL 5.4 ili noviji
  • Aktivan Cost+ trgovački račun
  • PrestaShop 1.7.x instalacija
  • PHP 5.4 ili noviji
  • Administratorski pristup vašem PrestaShop back officeu
  • MySQL 5.4 ili noviji
  • Aktivan Cost+ trgovački račun
  • PrestaShop 1.6.1.x instalacija
  • PHP 5.6 ili noviji (s ekstenzijama cURL i OpenSSL)
  • SSL/HTTPS omogućen na trgovini
  • Administratorski pristup vašem PrestaShop back officeu

1. Instalirajte modul

Preuzmite modul s GitHuba.

Metoda A: Učitavanje putem administratorske ploče (preporučeno)

  1. Idite na Modules → Module Manager u administratorskoj ploči
  2. Kliknite Upload a module
  3. Povucite i ispustite ZIP datoteku ili je odaberite ručno
  4. Pričekajte da instalacija završi
  5. Pretražite "NoPayn" i kliknite Configure

Metoda B: Ručno učitavanje

  1. Kopirajte mapu nopaynpayment/ u PrestaShop modules/ direktorij
  2. Idite na Modules → Module Manager
  3. Pretražite "NoPayn" i kliknite Install
  4. Kliknite Configure za otvaranje postavki

Preuzmite modul s GitHuba.

Metoda A: Učitavanje putem administratorske ploče (preporučeno)

  1. Idite na Improve > Module Manager u administratorskoj ploči
  2. Kliknite Upload a module
  3. Povucite i ispustite ZIP datoteku ili je odaberite ručno
  4. Pričekajte da instalacija završi
  5. Pomaknite se prema dolje do odjeljka "Other" i kliknite Configure pod Cost+

PrestaShop 8 Module Manager

Dijalog za učitavanje modula

Metoda B: Ručno učitavanje putem (S)FTP-a

  1. Raspakirajte preuzetu ZIP datoteku
  2. Koristeći SFTP klijent (npr. FileZilla, WinSCP), učitajte sve mape u /modules/ direktorij vaše PrestaShop instalacije
  3. Idite na Improve > Modules > Module Catalog
  4. Pretražite "Cost+" -- provjerite karticu Uninstalled Modules ako je potrebno
  5. Kliknite Install

Preuzmite modul s GitHuba.

Metoda A: Učitavanje putem administratorske ploče (preporučeno)

  1. Idite na Improve > Module Manager u administratorskoj ploči
  2. Kliknite Upload a module
  3. Povucite i ispustite ZIP datoteku ili je odaberite ručno
  4. Pričekajte da instalacija završi
  5. Pomaknite se prema dolje do odjeljka "Other" i kliknite Configure pod Cost+

PrestaShop 1.7 Module Manager

Dijalog za učitavanje modula

Metoda B: Ručno učitavanje putem (S)FTP-a

  1. Raspakirajte preuzetu ZIP datoteku
  2. Koristeći SFTP klijent (npr. FileZilla, WinSCP), učitajte sve mape u /modules/ direktorij vaše PrestaShop instalacije
  3. Idite na Modules > Module Manager
  4. Pretražite "Cost+" -- provjerite karticu Uninstalled Modules ako je potrebno
  5. Kliknite Install

Preuzmite modul s GitHuba.

Metoda A: Učitavanje putem administratorske ploče (preporučeno)

  1. Preuzmite costpluspayment.zip sa stranice GitHub Releases
  2. Idite na Modules and Services u PrestaShop back officeu
  3. Kliknite Add a new module
  4. Učitajte ZIP datoteku
  5. Pronađite Cost+ Payment Gateway na popisu modula i kliknite Install

Metoda B: Ručno učitavanje putem (S)FTP-a

  1. Raspakirajte preuzetu ZIP datoteku
  2. Koristeći SFTP klijent, učitajte mapu costpluspayment/ u /modules/costpluspayment/ na vašoj PrestaShop instalaciji
  3. Idite na Modules and Services u back officeu
  4. Pronađite Cost+ Payment Gateway i kliknite Install

2. Unesite API vjerodajnice

Prijavite se u portal trgovca i idite na Websites, zatim kliknite na web stranicu koju želite povezati. Kliknite na Integration gdje ćete pronaći svoj API ključ.

Cost+ portal trgovca s prikazom API ključa

U konfiguraciji NoPayn modula unesite svoj API ključ i konfigurirajte sljedeće postavke:

PostavkaOpis
API KeyVaš NoPayn API ključ
Credit / Debit CardOmogući/onemogući plaćanja karticama
Apple PayOmogući/onemogući Apple Pay
Google PayOmogući/onemogući Google Pay
Vipps MobilePayOmogući/onemogući Vipps MobilePay
Manual CaptureSamo autorizirajte plaćanja karticama — naplatite kad isporučite
Debug LoggingOmogući detaljno zapisivanje u var/logs/nopayn_debug.log

Zalijepite ključ u polje API Key na stranici konfiguracije Cost+ biblioteke i kliknite Save.

Stranica konfiguracije Cost+ u PrestaShop 8

Zalijepite ključ u polje API Key na stranici konfiguracije Cost+ biblioteke i kliknite Save.

Stranica konfiguracije Cost+ u PrestaShop 1.7

Nakon instalacije, kliknite Configure na modulu Cost+ Payment Gateway i postavite sljedeće:

PostavkaOpis
API KeyVaš Cost+ API ključ s portala trgovca
Credit / Debit CardOmogući/onemogući plaćanja karticama
Apple PayOmogući/onemogući Apple Pay
Google PayOmogući/onemogući Google Pay
Vipps MobilePayOmogući/onemogući Vipps MobilePay
Manual CaptureSamo autorizirajte plaćanja karticama — naplatite kad isporučite
Checkout ExpiryVrijeme isteka narudžbe na čekanju u minutama (zadano 5)
Debug LoggingOmogući detaljno zapisivanje u log/costplus_debug.log

Nakon spremanja, otvorite Payment > Restrictions i omogućite modul Cost+ Payment Gateway za svaku valutu koju prihvaćate.

Za hosting okruženja PrestaShop 8.x, 1.7 i 1.6, omogućite opciju cURL CA bundle tijekom konfiguracije kako biste izbjegli probleme s SSL certifikatima.

3. Omogućite načine plaćanja

Načini plaćanja konfiguriraju se izravno u postavkama modula (pogledajte korak 2 iznad). Uključite ili isključite svaki način prema potrebi.

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

Nakon spremanja API ključa, učitajte svaki modul načina plaćanja zasebno putem Upload a module.

Vratite se na Improve > Module Manager, kliknite Upload a module ponovno i učitajte svaku ZIP datoteku za načine plaćanja koje želite omogućiti (npr. kreditna kartica, MobilePay, Swish).

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

Moduli plaćanja imat će ili opciju Configure (ako je potrebno dodatno postavljanje) ili samo prekidač za omogućavanje/onemogućavanje.

Nakon spremanja API ključa, učitajte svaki modul načina plaćanja zasebno putem Upload a module.

Vratite se na Improve > Module Manager, kliknite Upload a module ponovno i učitajte svaku ZIP datoteku za načine plaćanja koje želite omogućiti (npr. kreditna kartica, MobilePay, Swish).

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

Moduli plaćanja imat će ili opciju Configure (ako je potrebno dodatno postavljanje) ili samo prekidač za omogućavanje/onemogućavanje.

Načini plaćanja se uključuju izravno na stranici konfiguracije modula (pogledajte korak 2 iznad). Omogućite svaki način koji želite imati dostupan na blagajni.

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

Tijek plaćanja

  1. Kupac odabire Cost+ način plaćanja na blagajni
  2. Kupac se preusmjerava na Cost+ hosted stranicu za plaćanje (HPP)
  3. Nakon dovršetka plaćanja, kupac se preusmjerava natrag u trgovinu
  4. Webhook potvrđuje status plaćanja između poslužitelja

Webhook

Webhook URL automatski se konfigurira po narudžbi:

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

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

Ručna naplata

Kada je omogućena za plaćanja karticama:

  • Plaćanje se autorizira ali ne naplaćuje na blagajni
  • Naplata se vrši kada se narudžba isporuči / označi kao dovršena
  • Ako se narudžba poništi, autorizacija se automatski poništava

Automatski povrat

Ako se poništi narudžba s naplaćenim plaćanjem, modul automatski izdaje potpuni povrat. Djelomični povrati mogu se obraditi putem PrestaShop kreditnih slipova.

Oznake gumba na blagajni

Za najbolje korisničko iskustvo s tijekovima preusmjeravanja na vanjske stranice, razmotrite ažuriranje oznake gumba na blagajni u "Pregledaj narudžbu" umjesto "Potvrdi i plati", budući da se stvarno plaćanje odvija na Cost+ hosted stranici. Ovo je globalna PrestaShop postavka, nije specifična za modul.

Webhook

Webhook se automatski konfigurira od strane modula. Ručno postavljanje nije potrebno.

Webhook

Webhook se automatski konfigurira od strane modula. Ručno postavljanje nije potrebno.

Webhook

Stranica konfiguracije modula prikazuje URL webhooka. Kopirajte ga u svoju Cost+ nadzornu ploču ako vaš Cost+ račun zahtijeva statičku registraciju webhooka.

Endpoint webhooka prima Cost+ događaje, zatim ponovno poziva Cost+ s GET /orders/{id} prije ažuriranja PrestaShop narudžbe — to čini obradu URL-a za povratak i webhooka idempotentnom.

Cron za istek

Stranica konfiguracije modula prikazuje URL cron-a za istek. Zakažite ga da se izvodi svake minute:

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

Koristite točan URL prikazan u back officeu vašeg PrestaShopa — token se generira tijekom instalacije i različit je za svaku trgovinu. Endpoint cron-a otkazuje zastarjele narudžbe Cost+ na čekanju nakon konfiguriranog Checkout Expiry.

Ručna naplata i povrati

  • S omogućenim Manual Capture, plaćanja se autoriziraju na blagajni i naplaćuju kada se narudžba isporuči / označi kao dovršena
  • Ako se naplaćena narudžba poništi, modul automatski izdaje potpuni povrat
  • Djelomični povrati obrađuju se kroz PrestaShop kreditne slipove

4. Završni koraci i testiranje

  1. Još jednom provjerite sve omogućene načine plaćanja
  2. Napravite nekoliko testnih transakcija -- i uspješnih i neuspjelih -- kako biste osigurali da sve teče glatko
  3. Konfigurirajte napredno ponašanje poput ručne naspram automatske naplate ovisno o vašem procesu ispunjenja

Podrška

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

On this page