Cost+Docs

osCommerce

Integrujte Cost+ s vasim obchodom osCommerce 4 pomocou oficialneho platobneho modulu

osCommerce

Integrujte Cost+ ako platobnu metodu vo vasom obchode osCommerce 4. Oficialny modul NoPayn Payments pouziva proces hostovanej platobnej stranky, takze ziadne udaje kariet sa nedotknu vasho servera -- plne kompatibilny s PCI DSS.

Predpoklady

  • Aktivny ucet obchodnika Cost+
  • osCommerce 4.x
  • PHP 8.1 alebo novsi
  • Rozsirenie cURL aktivovane
  • SSL certifikat (vyzadovany HTTPS)
  • Administratorsky pristup k vasmu administratorskemu panelu osCommerce

Podporovane platobne metody

Popisok pri pokladniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Kazdu metodu je mozne individualne aktivovat alebo deaktivovat z administratorskeho panelu.

1. Instalacia modulu

Stiahnite alebo klonujte modul z GitHub.

Skopiujte adresar lib/ do korena vasho osCommerce 4:

cp -r lib/ /path/to/oscommerce/

Toto umiestni subory modulu 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

V administratorskom paneli vasho osCommerce:

  1. Prejdite na Modules -> Payment -> Online
  2. Aktivujte filtre "Show inactive" a "Show not installed", ak je to potrebne
  3. Najdite NoPayn Payments a kliknite na Install

2. Konfiguracia modulu

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

Zadajte svoj API kluc a nakonfigurujte nasledujuce nastavenia:

NastaveniePopisPredvolene
Enable NoPayn PaymentsHlavny prepinac aktivacie/deaktivacieTrue
API KeyVas NoPayn API kluc--
Enable Credit / Debit CardZobrazenie kreditnej/debetnej karty pri pokladniTrue
Enable Apple PayZobrazenie Apple Pay pri pokladniTrue
Enable Google PayZobrazenie Google Pay pri pokladniTrue
Enable Vipps MobilePayZobrazenie Vipps MobilePay pri pokladniTrue
Manual Capture (Credit Card)Len autorizacia -- zachytenie pri dokonceni objednavkyFalse
Debug LoggingZapisovanie API poziadaviek/odpovedi do loguFalse
Completed Order StatusStav nastaveny pri uspechu platbyProcessing
Pending Order StatusStav nastaveny pocas cakanej platbyPending
Cancelled Order StatusStav nastaveny pri zruseni/neuspechu/exspiraciiCancelled
Payment ZoneObmedzenie na geograficku zonu (volitelne)Vsetky zony
Sort OrderPoradie zobrazenia na stranke pokladne0

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

3. Aktualizacia popiskov pokladne (odporucane)

Predvolene popisky tlacidiel pokladne osCommerce predpokladaju jednokrokovy proces. Pre lepsi zaziatok s presmerovanim na externu platobnu stranku aktualizujte tieto preklady v Admin -> Localisation -> Languages -> English -> Define:

KlucPredvoleneOdporucane
TEXT_PAY_WITH_CARDPay with cardGo to payment
TEXT_CONFIRM_AND_PAYConfirm and payReview order
CONFIRM_ORDERConfirm orderConfirm and pay

Toto zlepsuje zakaznicky zaziatok tym, ze proces pokladne je jasnejsi -- zakaznici pochopia, ze budu presmerovani na dokoncenie platby na bezpecnej stranke.

4. Platobny proces

Po konfiguracii platobny proces funguje nasledovne:

  1. Zakaznik si vyberie platobnu metodu Cost+ pri pokladni
  2. Zakaznik potvrdi objednavku
  3. Modul vytvori cakajucu objednavku a zavola Cost+ API
  4. Zakaznik je presmerovany na hostovanu platobnu stranku Cost+ (HPP)
  5. Zakaznik dokonci platbu na bezpecnej HPP
  6. Zakaznik je presmerovany spat do obchodu
  7. Modul overi stav platby cez Cost+ API
  8. Stav objednavky sa prislusne aktualizuje

Platobne odkazy vyprsia po 5 minutach. Ak zakaznik nedokonci platbu v tomto casovom okne, objednavka sa automaticky oznaci ako zrusena.

5. Webhooky

Modul registruje webhook URL s Cost+ pre server-to-server aktualizacie stavu. Ked sa zmeni stav platby, Cost+ posle notifikaciu a modul:

  1. Prijme webhook POST
  2. Overi stav platby cez API (nikdy neveri payloadu webhooku)
  3. Aktualizuje stav objednavky v osCommerce

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

Manualne zachytenie

Ked je aktivovane pre platby kreditnou kartou:

  • Platba je autorizovana, ale nie zachytena pri pokladni
  • Prostriedky sa zachytia, ked objednavka prejde do stavu completed
  • Ak je objednavka zrusena, autorizacia sa automaticky anuluje

Pouzite manualne zachytenie, ak chcete ucastovat zakaznikov az pri odoslani ich objednavky. Toto je uzitocne pre obchodnikov s dlhsimi casmi plnenia.

Ladiace logovanie

Ked je aktivovane Debug Logging, modul zapisuje do nopayn_debug.log v adresari logov osCommerce. Zaznamy logu zahrnuju:

  • Vsetky API poziadavky a odpovede
  • Udalosti webhookov a vysledky spracovania
  • Operacie zachytenia a zrusenia
  • Chyby (vzdy zaznamenavane bez ohladu na prepinac ladenia)

Vsetky zaznamy maju prefix NoPayn_ pre jednoduche filtrovanie.

Odinstalovanie

  1. Prejdite na Modules -> Payment -> Online v administratorskom paneli
  2. Vyberte NoPayn Payments
  3. Kliknite na Remove

Odinstalovanie modulu odstrani konfiguraciu a zrusi databazove tabulky nopayn_transactions a nopayn_refunds. Uistite sa, ze ste exportovali vsetky potrebne udaje pred odinstalovamim.

Testovanie a spustenie

Vykonajte niekolko testovacich transakcii, aby ste sa uistili, ze vsetko funguje spravne. Odporucame testovat uspesne aj neuspesne platby na potvrdenie spravneho spracovania vsetkych scenarov.

Podpora

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

On this page