Cost+Docs

OpenCart

Integrirajte Cost+ sa svojom OpenCart trgovinom (4.x i 3.x / ocStore 3)

OpenCart

Integrirajte Cost+ kao način plaćanja u svojoj OpenCart trgovini. Službeno proširenje NoPayn Payment Gateway dostupno je za OpenCart 4 i OpenCart 3 / ocStore 3.

Preduvjeti

  • Aktivan Cost+ trgovački račun
  • OpenCart 4.0.0.0 ili noviji
  • PHP 8.0 ili noviji
  • Administratorski pristup vašoj OpenCart nadzornoj ploči
  • Aktivan Cost+ trgovački račun
  • ocStore 3.0.x ili OpenCart 3.0.3.x
  • PHP 7.4 ili noviji
  • Administratorski pristup vašoj OpenCart nadzornoj ploči

Podržani načini plaćanja

  • 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. Instalirajte proširenje

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

  1. Preuzmite najnovije .ocmod.zip izdanje s GitHuba
  2. U OpenCart administraciji idite na Extensions → Installer
  3. Učitajte .ocmod.zip datoteku
  4. Idite na Extensions → Extensions → Payment
  5. Pronađite NoPayn Payment Gateway i kliknite Install, zatim Edit

Metoda B: Ručno učitavanje

  1. Preuzmite ili klonirajte repozitorij
  2. Kopirajte sadržaj mape upload/ u korijenski direktorij vašeg OpenCarta
  3. Idite na Extensions → Extensions → Payment
  4. Pronađite NoPayn Payment Gateway i kliknite Install, zatim Edit

Arhitektura

OpenCart 3 koristi postavku s više proširenja:

  • NoPayn - Global Settings — dijeljena konfiguracija (API ključ, statusi narudžbi, dostupnost metoda, ručna naplata, debug zapisivanje)
  • NoPayn - Card Payments — blagajna za kreditne/debitne kartice
  • NoPayn - Apple Pay / Google Pay — blagajna za novčanike (ako je omogućen samo jedan novčanik, oznaka se automatski prilagođava)
  • NoPayn - Vipps MobilePay — blagajna za Vipps/MobilePay
  • NoPayn - Swish — blagajna za Swish

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

  1. Preuzmite .ocmod.zip iz najnovijeg GitHub izdanja

Koristite .ocmod.zip iz izdanja — ne GitHubove automatski generirane "Source code" preuzimanja, koja sadrže raspored repozitorija, a ne raspored instalacije.

  1. U administraciji idite na Extensions → Installer
  2. Učitajte .ocmod.zip datoteku
  3. Idite na Extensions → Extensions → Payments
  4. Prvo instalirajte NoPayn - Global Settings
  5. Otvorite NoPayn - Global Settings i konfigurirajte:
    • API ključ
    • Statuse narudžbi za dovršene, čekajuće i poništene
    • Dostupne načine plaćanja za koje je vaš trgovački račun odobren
    • Opcionalno: ručna naplata kartica
    • Opcionalno: debug zapisivanje
  6. Instalirajte module za blagajnu koje želite prikazati:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Za svaki modul blagajne postavite: Status, Geo Zone i Sort Order

Metoda B: Ručno učitavanje

  1. Preuzmite ili klonirajte repozitorij
  2. Kopirajte sadržaj mape upload/ u korijenski direktorij vaše trgovine
  3. Idite na Extensions → Extensions → Payments
  4. Slijedite isti redoslijed instalacije kao u metodi A (prvo Global Settings, zatim moduli blagajne)

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 postavkama NoPayn Payment Gatewaya unesite svoj API ključ u odgovarajuće polje.

U NoPayn - Global Settings unesite svoj API ključ u odgovarajuće polje. API ključ se dijeli među svim modulima blagajne — trebate ga unijeti samo jednom.

3. Konfigurirajte postavke plaćanja

  1. Omogućite načine plaćanja za koje ste odobreni
  2. Postavite željene statuse narudžbi za dovršena, čekajuća i poništena plaćanja
  3. Opcionalno ograničite plaćanja prema Geo Zone
  4. Postavite Status na Enabled
  5. Kliknite Save

Globalne postavke

NoPayn - Global Settings pohranjuje svu dijeljenu konfiguraciju:

PostavkaOpis
API KeyVaš NoPayn API ključ
Order StatusesMapiranje statusa za dovršene, čekajuće i poništene
Method AvailabilityKoji su načini plaćanja odobreni za vaš trgovački račun
Manual CaptureSamo autorizirajte plaćanja karticama — naplatite kasnije
Debug LoggingOmogućite detaljno zapisivanje za rješavanje problema

Postavke modula blagajne

Svaki modul blagajne ima vlastite postavke za izlog:

PostavkaOpis
StatusOmogući ili onemogući ovaj način plaćanja na blagajni
Geo ZoneOgraniči na određene geografske zone
Sort OrderRedoslijed prikaza na stranici blagajne

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 NoPayn hosted stranicu za plaćanje
  3. Nakon plaćanja, kupac se vraća i status narudžbe se automatski ažurira
  4. NoPayn šalje webhook za asinkronu potvrdu statusa

Proširenje koristi Cost+ hosted stranicu za plaćanje, što znači da se kupci preusmjeravaju na siguran obrazac za plaćanje. Nikakvi osjetljivi podaci kartica ne prolaze kroz vaš poslužitelj.

Svaki modul blagajne je zasebno OpenCart proširenje za plaćanje, dajući kupcima različite radio opcije na blagajni (npr. "Card Payments", "Apple Pay & Google Pay").

  1. Kupac odabire oznaku načina plaćanja na blagajni (npr. Card Payments)
  2. Proširenje stvara NoPayn hosted narudžbu za plaćanje
  3. Kupac se preusmjerava na sigurnu NoPayn stranicu za plaćanje
  4. Nakon plaćanja, kupac se vraća i status narudžbe se automatski ažurira
  5. NoPayn šalje webhook za asinkronu potvrdu statusa

Modul Apple Pay / Google Pay šalje oba načina u jednoj transakciji tako da NoPayn hosted stranica može ponuditi obje opcije novčanika u jednom tijeku.

Nadogradnja s v1.0.0 na v2.0.0

Verzija 1.0.0 koristila je jednu metodu blagajne zvanu "NoPayn Checkout". Verzija 2.0.0 prelazi na zasebne module blagajne po načinu plaćanja. Prilikom nadogradnje:

  1. Učitajte novi paket
  2. Vaš postojeći unos "NoPayn Checkout" postaje NoPayn - Global Settings
  3. Pregledajte i spremite globalne postavke
  4. Instalirajte i omogućite nove module blagajne koje želite da kupci vide

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