osCommerce
Integrirajte Cost+ sa svojom osCommerce 4 trgovinom koristeći službeni modul za plaćanje

Integrirajte Cost+ kao način plaćanja u svojoj osCommerce 4 trgovini. Službeni modul NoPayn Payments koristi tijek hosted stranice za plaćanje, tako da nikakvi podaci kartica ne dodiruju vaš poslužitelj — potpuno usklađen s PCI DSS standardom.
Preduvjeti
- Aktivan Cost+ trgovački račun
- osCommerce 4.x
- PHP 8.1 ili noviji
- cURL proširenje omogućeno
- SSL certifikat (HTTPS obavezan)
- Administratorski pristup vašoj osCommerce administratorskoj ploči
Podržani načini plaćanja
| Oznaka na blagajni | NoPayn identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Svaki način se može pojedinačno omogućiti ili onemogućiti iz administratorske ploče.
1. Instalirajte modul
Preuzmite ili klonirajte modul s GitHuba.
Kopirajte lib/ direktorij u korijenski direktorij vašeg osCommercea 4:
cp -r lib/ /path/to/oscommerce/Ovo postavlja datoteke modula na:
lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.phpU administratorskoj ploči vašeg osCommercea:
- Idite na Modules → Payment → Online
- Omogućite filtre "Show inactive" i "Show not installed" ako je potrebno
- Pronađite NoPayn Payments i kliknite Install
2. Konfigurirajte modul
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č.

Unesite svoj API ključ i konfigurirajte sljedeće postavke:
| Postavka | Opis | Zadano |
|---|---|---|
| Enable NoPayn Payments | Glavni prekidač za omogućavanje/onemogućavanje | True |
| API Key | Vaš NoPayn API ključ | — |
| Enable Credit / Debit Card | Prikaži kreditnu/debitnu karticu na blagajni | True |
| Enable Apple Pay | Prikaži Apple Pay na blagajni | True |
| Enable Google Pay | Prikaži Google Pay na blagajni | True |
| Enable Vipps MobilePay | Prikaži Vipps MobilePay na blagajni | True |
| Manual Capture (Credit Card) | Samo autoriziraj — naplati kada se narudžba dovrši | False |
| Debug Logging | Zapisuj API zahtjeve/odgovore u zapisnik | False |
| Completed Order Status | Status postavljen kada plaćanje uspije | Processing |
| Pending Order Status | Status postavljen dok se čeka plaćanje | Pending |
| Cancelled Order Status | Status postavljen pri poništenju/neuspjehu/isteku | Cancelled |
| Payment Zone | Ograniči na geografsku zonu (neobavezno) | Sve zone |
| Sort Order | Redoslijed prikaza na stranici blagajne | 0 |
Aktivirajte samo one načine plaćanja za koje ste odobreni i za koje ste primili potvrdu.
3. Ažurirajte oznake blagajne (preporučeno)
Zadane oznake gumba osCommerce blagajne pretpostavljaju jednostupanjski tijek. Za bolje iskustvo s preusmjeravanjem na vanjsku stranicu za plaćanje, ažurirajte ove prijevode u Admin → Localisation → Languages → English → Define:
| Ključ | Zadano | Preporučeno |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Go to payment |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Review order |
CONFIRM_ORDER | Confirm order | Confirm and pay |
Ovo poboljšava korisničko iskustvo čineći tijek blagajne jasnijim — kupci razumiju da će biti preusmjereni za dovršetak plaćanja na sigurnoj stranici.
4. Tijek plaćanja
Nakon konfiguracije, tijek plaćanja funkcionira na sljedeći način:
- Kupac odabire Cost+ način plaćanja na blagajni
- Kupac potvrđuje narudžbu
- Modul stvara narudžbu na čekanju i poziva Cost+ API
- Kupac se preusmjerava na Cost+ hosted stranicu za plaćanje (HPP)
- Kupac dovršava plaćanje na sigurnoj HPP stranici
- Kupac se preusmjerava natrag u trgovinu
- Modul provjerava status plaćanja putem Cost+ API-ja
- Status narudžbe se ažurira u skladu s tim
Poveznice za plaćanje istječu nakon 5 minuta. Ako kupac ne dovrši plaćanje unutar tog vremenskog okvira, narudžba se automatski označava kao poništena.
5. Webhookovi
Modul registrira webhook URL s Cost+ za ažuriranja statusa između poslužitelja. Kada se status plaćanja promijeni, Cost+ šalje obavijest i modul:
- Prima webhook POST
- Provjerava status plaćanja putem API-ja (nikada ne vjeruje samo webhook podacima)
- Ažurira status narudžbe u osCommerceu
Ručna konfiguracija webhookova nije potrebna — modul automatski upravlja registracijom.
Ručna naplata
Kada je omogućena za plaćanja kreditnim karticama:
- Plaćanje se autorizira ali ne naplaćuje na blagajni
- Sredstva se naplaćuju kada narudžba prijeđe u status completed
- Ako se narudžba poništi, autorizacija se automatski poništava
Koristite ručnu naplatu ako želite naplatiti kupcima tek kada se njihova narudžba pošalje. Ovo je korisno za trgovce s duljim vremenima ispunjenja.
Debug zapisivanje
Kada je Debug Logging omogućeno, modul zapisuje u nopayn_debug.log u direktoriju zapisnika osCommercea. Zapisi uključuju:
- Sve API zahtjeve i odgovore
- Webhook događaje i rezultate obrade
- Operacije naplate i poništenja
- Greške (uvijek se zapisuju, bez obzira na debug prekidač)
Svi zapisi imaju prefiks NoPayn_ za jednostavno filtriranje.
Deinstalacija
- Idite na Modules → Payment → Online u administratorskoj ploči
- Odaberite NoPayn Payments
- Kliknite Remove
Deinstalacija modula uklanja konfiguraciju i briše tablice baze podataka nopayn_transactions i nopayn_refunds. Pobrinite se da izvezete sve podatke koji su vam potrebni prije deinstalacije.
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.