Cost+Docs

osCommerce

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

osCommerce

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 blagajniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-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.php

U administratorskoj ploči vašeg osCommercea:

  1. Idite na Modules → Payment → Online
  2. Omogućite filtre "Show inactive" i "Show not installed" ako je potrebno
  3. 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č.

Cost+ portal trgovca s prikazom API ključa

Unesite svoj API ključ i konfigurirajte sljedeće postavke:

PostavkaOpisZadano
Enable NoPayn PaymentsGlavni prekidač za omogućavanje/onemogućavanjeTrue
API KeyVaš NoPayn API ključ—
Enable Credit / Debit CardPrikaži kreditnu/debitnu karticu na blagajniTrue
Enable Apple PayPrikaži Apple Pay na blagajniTrue
Enable Google PayPrikaži Google Pay na blagajniTrue
Enable Vipps MobilePayPrikaži Vipps MobilePay na blagajniTrue
Manual Capture (Credit Card)Samo autoriziraj — naplati kada se narudžba dovršiFalse
Debug LoggingZapisuj API zahtjeve/odgovore u zapisnikFalse
Completed Order StatusStatus postavljen kada plaćanje uspijeProcessing
Pending Order StatusStatus postavljen dok se čeka plaćanjePending
Cancelled Order StatusStatus postavljen pri poništenju/neuspjehu/istekuCancelled
Payment ZoneOgraniči na geografsku zonu (neobavezno)Sve zone
Sort OrderRedoslijed prikaza na stranici blagajne0

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čZadanoPreporučeno
TEXT_PAY_WITH_CARDPay with cardGo to payment
TEXT_CONFIRM_AND_PAYConfirm and payReview order
CONFIRM_ORDERConfirm orderConfirm 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:

  1. Kupac odabire Cost+ način plaćanja na blagajni
  2. Kupac potvrđuje narudžbu
  3. Modul stvara narudžbu na čekanju i poziva Cost+ API
  4. Kupac se preusmjerava na Cost+ hosted stranicu za plaćanje (HPP)
  5. Kupac dovršava plaćanje na sigurnoj HPP stranici
  6. Kupac se preusmjerava natrag u trgovinu
  7. Modul provjerava status plaćanja putem Cost+ API-ja
  8. 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:

  1. Prima webhook POST
  2. Provjerava status plaćanja putem API-ja (nikada ne vjeruje samo webhook podacima)
  3. 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

  1. Idite na Modules → Payment → Online u administratorskoj ploči
  2. Odaberite NoPayn Payments
  3. 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.

On this page