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

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 pokladni | NoPayn identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-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.phpV administratorskom paneli vasho osCommerce:
- Prejdite na Modules -> Payment -> Online
- Aktivujte filtre "Show inactive" a "Show not installed", ak je to potrebne
- 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.

Zadajte svoj API kluc a nakonfigurujte nasledujuce nastavenia:
| Nastavenie | Popis | Predvolene |
|---|---|---|
| Enable NoPayn Payments | Hlavny prepinac aktivacie/deaktivacie | True |
| API Key | Vas NoPayn API kluc | -- |
| Enable Credit / Debit Card | Zobrazenie kreditnej/debetnej karty pri pokladni | True |
| Enable Apple Pay | Zobrazenie Apple Pay pri pokladni | True |
| Enable Google Pay | Zobrazenie Google Pay pri pokladni | True |
| Enable Vipps MobilePay | Zobrazenie Vipps MobilePay pri pokladni | True |
| Manual Capture (Credit Card) | Len autorizacia -- zachytenie pri dokonceni objednavky | False |
| Debug Logging | Zapisovanie API poziadaviek/odpovedi do logu | False |
| Completed Order Status | Stav nastaveny pri uspechu platby | Processing |
| Pending Order Status | Stav nastaveny pocas cakanej platby | Pending |
| Cancelled Order Status | Stav nastaveny pri zruseni/neuspechu/exspiracii | Cancelled |
| Payment Zone | Obmedzenie na geograficku zonu (volitelne) | Vsetky zony |
| Sort Order | Poradie zobrazenia na stranke pokladne | 0 |
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:
| Kluc | Predvolene | Odporucane |
|---|---|---|
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 |
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:
- Zakaznik si vyberie platobnu metodu Cost+ pri pokladni
- Zakaznik potvrdi objednavku
- Modul vytvori cakajucu objednavku a zavola Cost+ API
- Zakaznik je presmerovany na hostovanu platobnu stranku Cost+ (HPP)
- Zakaznik dokonci platbu na bezpecnej HPP
- Zakaznik je presmerovany spat do obchodu
- Modul overi stav platby cez Cost+ API
- 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:
- Prijme webhook POST
- Overi stav platby cez API (nikdy neveri payloadu webhooku)
- 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
- Prejdite na Modules -> Payment -> Online v administratorskom paneli
- Vyberte NoPayn Payments
- 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.