DocsosCommerce
Integrujte Cost+ s vaším osCommerce 4 obchodem pomocí oficiálního platebního modulu
Integrujte Cost+ jako platební metodu do vašeho osCommerce 4 obchodu. Oficiální modul NoPayn Payments používá tok hostované platební stránky, takže se na vašem serveru nezpracovávají žádná data karet — plně v souladu s PCI DSS.
Předpoklady
- Aktivní obchodní účet Cost+
- osCommerce 4.x
- PHP 8.1 nebo novější
- Povolené rozšíření cURL
- SSL certifikát (vyžadováno HTTPS)
- Administrátorský přístup k panelu správy osCommerce
Podporované platební metody
| Popisek v checkoutu | NoPayn identifikátor |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Každou metodu lze jednotlivě povolit nebo zakázat z administračního panelu.
1. Nainstalujte modul
Stáhněte nebo naklonujte modul z GitHubu.
Zkopírujte adresář lib/ do kořenového adresáře osCommerce 4:
cp -r lib/ /path/to/oscommerce/Tím se soubory modulu umístí 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 administračním panelu osCommerce:
- Přejděte na Modules → Payment → Online
- Pokud je potřeba, povolte filtry "Show inactive" a "Show not installed"
- Najděte NoPayn Payments a klikněte na Install
2. Nakonfigurujte modul
Přihlaste se do obchodního portálu a přejděte na Weby, poté klikněte na web, který chcete propojit. Klikněte na Integrace, kde najdete svůj API klíč.
Zadejte svůj API Key a nakonfigurujte následující nastavení:
| Nastavení | Popis | Výchozí |
|---|---|---|
| Enable NoPayn Payments | Hlavní přepínač zapnout/vypnout | True |
| API Key | Váš NoPayn API klíč | — |
| Enable Credit / Debit Card | Zobrazit kartu při checkoutu | True |
| Enable Apple Pay | Zobrazit Apple Pay při checkoutu | True |
| Enable Google Pay | Zobrazit Google Pay při checkoutu | True |
| Enable Vipps MobilePay | Zobrazit Vipps MobilePay při checkoutu | True |
| Manual Capture (Credit Card) | Pouze autorizovat — zachytit při dokončení objednávky | False |
| Debug Logging | Zapisovat API požadavky/odpovědi do logu | False |
| Completed Order Status | Stav nastavený při úspěšné platbě | Processing |
| Pending Order Status | Stav nastavený při čekání na platbu | Pending |
| Cancelled Order Status | Stav nastavený při zrušení/selhání/vypršení | Cancelled |
| Payment Zone | Omezit na geografickou zónu (volitelné) | All zones |
| Sort Order | Pořadí zobrazení na stránce checkoutu | 0 |
Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.
3. Aktualizujte popisky checkoutu (doporučeno)
Výchozí popisky tlačítek checkoutu osCommerce předpokládají jednokrokový tok. Pro lepší zážitek s přesměrováním na externí platbu aktualizujte tyto překlady v Admin → Localisation → Languages → English → Define:
| Klíč | Výchozí | Doporučené |
|---|---|---|
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 |
To zlepší zákaznický zážitek tím, že tok checkoutu bude jasnější — zákazníci pochopí, že budou přesměrováni k dokončení platby na bezpečné stránce.
4. Platební tok
Po konfiguraci platební tok funguje následovně:
- Zákazník vybere platební metodu Cost+ při checkoutu
- Zákazník potvrdí objednávku
- Modul vytvoří čekající objednávku a zavolá API Cost+
- Zákazník je přesměrován na hostovanou platební stránku Cost+ (HPP)
- Zákazník dokončí platbu na bezpečné HPP
- Zákazník je přesměrován zpět do obchodu
- Modul ověří stav platby prostřednictvím API Cost+
- Stav objednávky je odpovídajícím způsobem aktualizován
Platební odkazy vyprší po 5 minutách. Pokud zákazník nedokončí platbu v tomto okně, objednávka je automaticky označena jako zrušená.
5. Webhooky
Modul registruje webhook URL u Cost+ pro server-to-server aktualizace stavu. Když se změní stav platby, Cost+ odešle notifikaci a modul:
- Přijme webhookový POST
- Ověří stav platby přes API (nikdy nevěří webhookovému payloadu)
- Aktualizuje stav objednávky v osCommerce
Ruční konfigurace webhooku není nutná — modul zajišťuje registraci automaticky.
Manuální zachycení
Pokud je povoleno pro platby kartou:
- Platba je při checkoutu autorizována, ale nezachycena
- Prostředky jsou zachyceny, když objednávka přejde do stavu completed
- Pokud je objednávka zrušena, autorizace je automaticky zrušena (void)
Použijte manuální zachycení, pokud chcete účtovat zákazníkům teprve při odeslání objednávky. To je užitečné pro obchodníky s delšími lhůtami plnění.
Ladící logování
Když je Debug Logging povoleno, modul zapisuje do nopayn_debug.log v adresáři logů osCommerce. Záznamy logu zahrnují:
- Všechny API požadavky a odpovědi
- Webhookové události a výsledky zpracování
- Operace zachycení a zrušení
- Chyby (logují se vždy, bez ohledu na přepínač ladění)
Všechny záznamy mají prefix NoPayn_ pro snadné filtrování.
Odinstalace
- Přejděte na Modules → Payment → Online v administračním panelu
- Vyberte NoPayn Payments
- Klikněte na Remove
Odinstalace modulu odstraní konfiguraci a smaže databázové tabulky nopayn_transactions a nopayn_refunds. Před odinstalací se ujistěte, že máte exportovaná veškerá potřebná data.
Otestujte a spusťte
Proveďte několik testovacích transakcí, abyste se ujistili, že vše funguje hladce. Doporučujeme otestovat jak úspěšné, tak neúspěšné platby pro ověření, že jsou všechny scénáře správně zpracovány.
Podpora
Potřebujete pomoc? Obraťte se na náš tým podpory na support@costplus.io.