Cost+Docs

PrestaShop

Integrujte Cost+ s vaším PrestaShop obchodem (9.x, 8.x, 1.7 a 1.6)

PrestaShop

Integrujte Cost+ jako platební metodu do vašeho PrestaShop obchodu. Modul Cost+ je k dispozici pro PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 a PrestaShop 1.6.1.x.

Předpoklady

  • Aktivní obchodní účet Cost+
  • PrestaShop 9.1 nebo novější
  • PHP 8.1 nebo novější
  • Povolené SSL/HTTPS
  • Administrátorský přístup k back office PrestaShop
  • Aktivní obchodní účet Cost+
  • Instalace PrestaShop 8.x
  • PHP 8.0 nebo novější
  • Administrátorský přístup k back office PrestaShop
  • MySQL 5.4 nebo vyšší
  • Aktivní obchodní účet Cost+
  • Instalace PrestaShop 1.7.x
  • PHP 5.4 nebo novější
  • Administrátorský přístup k back office PrestaShop
  • MySQL 5.4 nebo vyšší
  • Aktivní obchodní účet Cost+
  • Instalace PrestaShop 1.6.1.x
  • PHP 5.6 nebo novější (s rozšířeními cURL a OpenSSL)
  • Povolené SSL/HTTPS na obchodě
  • Administrátorský přístup k back office PrestaShop

1. Nainstalujte modul

Stáhněte modul z GitHubu.

Metoda A: Nahrání přes administrační panel (doporučeno)

  1. Přejděte na Modules → Module Manager v administraci
  2. Klikněte na Upload a module
  3. Přetáhněte ZIP soubor nebo ho vyberte ručně
  4. Počkejte na dokončení instalace
  5. Vyhledejte „NoPayn" a klikněte na Configure

Metoda B: Ruční nahrání

  1. Zkopírujte složku nopaynpayment/ do adresáře modules/ PrestaShop
  2. Přejděte na Modules → Module Manager
  3. Vyhledejte „NoPayn" a klikněte na Install
  4. Klikněte na Configure pro otevření nastavení

Stáhněte modul z GitHubu.

Metoda A: Nahrání přes administrační panel (doporučeno)

  1. Přejděte na Improve > Module Manager v administraci
  2. Klikněte na Upload a module
  3. Přetáhněte ZIP soubor nebo ho vyberte ručně
  4. Počkejte na dokončení instalace
  5. Přejděte dolů do sekce „Other" a klikněte na Configure pod Cost+

PrestaShop 8 Module Manager

Dialog pro nahrání modulu

Metoda B: Ruční nahrání přes (S)FTP

  1. Rozbalte stažený ZIP soubor
  2. Pomocí SFTP klienta (např. FileZilla, WinSCP) nahrajte všechny složky do adresáře /modules/ vaší PrestaShop instalace
  3. Přejděte na Improve > Modules > Module Catalog
  4. Vyhledejte „Cost+" -- pokud je potřeba, zkontrolujte záložku Uninstalled Modules
  5. Klikněte na Install

Stáhněte modul z GitHubu.

Metoda A: Nahrání přes administrační panel (doporučeno)

  1. Přejděte na Improve > Module Manager v administraci
  2. Klikněte na Upload a module
  3. Přetáhněte ZIP soubor nebo ho vyberte ručně
  4. Počkejte na dokončení instalace
  5. Přejděte dolů do sekce „Other" a klikněte na Configure pod Cost+

PrestaShop 1.7 Module Manager

Dialog pro nahrání modulu

Metoda B: Ruční nahrání přes (S)FTP

  1. Rozbalte stažený ZIP soubor
  2. Pomocí SFTP klienta (např. FileZilla, WinSCP) nahrajte všechny složky do adresáře /modules/ vaší PrestaShop instalace
  3. Přejděte na Modules > Module Manager
  4. Vyhledejte „Cost+" -- pokud je potřeba, zkontrolujte záložku Uninstalled Modules
  5. Klikněte na Install

Stáhněte modul z GitHubu.

Metoda A: Nahrání přes administrační panel (doporučeno)

  1. Stáhněte costpluspayment.zip ze stránky GitHub Releases
  2. Přejděte na Modules and Services v back office PrestaShop
  3. Klikněte na Add a new module
  4. Nahrajte ZIP soubor
  5. Najděte Cost+ Payment Gateway v seznamu modulů a klikněte na Install

Metoda B: Ruční nahrání přes (S)FTP

  1. Rozbalte stažený ZIP soubor
  2. Pomocí SFTP klienta nahrajte složku costpluspayment/ do /modules/costpluspayment/ ve vaší PrestaShop instalaci
  3. Přejděte na Modules and Services v back office
  4. Najděte Cost+ Payment Gateway a klikněte na Install

2. Zadejte API přihlašovací údaje

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íč.

Obchodní portál Cost+ zobrazující API klíč

V konfiguraci modulu NoPayn zadejte svůj API Key a nakonfigurujte následující nastavení:

NastaveníPopis
API KeyVáš NoPayn API klíč
Credit / Debit CardPovolit/zakázat platby kartou
Apple PayPovolit/zakázat Apple Pay
Google PayPovolit/zakázat Google Pay
Vipps MobilePayPovolit/zakázat Vipps MobilePay
Manual CaptureAutorizovat platby kartou — zachytit při odeslání
Debug LoggingPovolit podrobné logování do var/logs/nopayn_debug.log

Vložte klíč do pole API Key na konfigurační stránce Cost+ Library a klikněte na Save.

Konfigurační stránka Cost+ v PrestaShop 8

Vložte klíč do pole API Key na konfigurační stránce Cost+ Library a klikněte na Save.

Konfigurační stránka Cost+ v PrestaShop 1.7

Po instalaci klikněte na Configure u modulu Cost+ Payment Gateway a nastavte následující:

NastaveníPopis
API KeyVáš Cost+ API klíč z obchodního portálu
Credit / Debit CardPovolit/zakázat platby kartou
Apple PayPovolit/zakázat Apple Pay
Google PayPovolit/zakázat Google Pay
Vipps MobilePayPovolit/zakázat Vipps MobilePay
Manual CaptureAutorizovat platby kartou — zachytit při odeslání
Checkout ExpiryČasový limit nevyřízené objednávky v minutách (výchozí 5)
Debug LoggingPovolit podrobné logování do log/costplus_debug.log

Po uložení otevřete Payment > Restrictions a povolte modul Cost+ Payment Gateway pro každou měnu, kterou přijímáte.

Pro hostingová prostředí PrestaShop 8.x, 1.7 a 1.6 povolte při konfiguraci možnost cURL CA bundle, abyste předešli problémům s SSL certifikáty.

3. Povolte platební metody

Platební metody se konfigurují přímo v nastavení modulu (viz krok 2 výše). Jednotlivé metody zapněte nebo vypněte podle potřeby.

Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.

Po uložení API klíče nahrajte každý modul platební metody zvlášť přes Upload a module.

Vraťte se na Improve > Module Manager, klikněte znovu na Upload a module a nahrajte každý ZIP soubor pro platební metody, které chcete povolit (např. Credit Card, MobilePay, Swish).

Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.

Platební moduly budou mít buď možnost Configure (pokud je potřeba další nastavení), nebo jen přepínač Povolit/Zakázat.

Po uložení API klíče nahrajte každý modul platební metody zvlášť přes Upload a module.

Vraťte se na Improve > Module Manager, klikněte znovu na Upload a module a nahrajte každý ZIP soubor pro platební metody, které chcete povolit (např. Credit Card, MobilePay, Swish).

Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.

Platební moduly budou mít buď možnost Configure (pokud je potřeba další nastavení), nebo jen přepínač Povolit/Zakázat.

Platební metody se přepínají přímo na konfigurační stránce modulu (viz krok 2 výše). Povolte každou metodu, kterou chcete mít dostupnou v checkoutu.

Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.

Platební tok

  1. Zákazník vybere platební metodu Cost+ při checkoutu
  2. Zákazník je přesměrován na hostovanou platební stránku Cost+ (HPP)
  3. Po dokončení platby je zákazník přesměrován zpět do obchodu
  4. Webhook potvrdí stav platby server-to-server

Webhook

Webhook URL je automaticky konfigurována pro každou objednávku:

https://your-shop.com/module/nopaynpayment/webhook

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
  • Zachycení proběhne při odeslání objednávky / označení jako dokončená
  • Pokud je objednávka zrušena, autorizace je automaticky zrušena (void)

Automatická refundace

Pokud je zachycená platební objednávka zrušena, modul automaticky provede úplnou refundaci. Částečné refundace lze zpracovat prostřednictvím dobropisů PrestaShop.

Popisky tlačítek checkoutu

Pro nejlepší uživatelský zážitek s toky přesměrování mimo web zvažte aktualizaci popisku tlačítka checkoutu na „Review order" místo „Confirm and pay", protože samotná platba probíhá na hostované stránce Cost+. Jedná se o globální nastavení PrestaShop, nikoli specifické pro modul.

Webhook

Webhook je automaticky konfigurován modulem. Ruční nastavení není nutné.

Webhook

Webhook je automaticky konfigurován modulem. Ruční nastavení není nutné.

Webhook

Konfigurační stránka modulu zobrazuje URL webhooku. Zkopírujte ji do svého Cost+ dashboardu pokud váš Cost+ účet vyžaduje statickou registraci webhooku.

Endpoint webhooku přijímá události Cost+, poté znovu volá Cost+ pomocí GET /orders/{id} před aktualizací objednávky PrestaShop — díky tomu je zpracování návratové URL a webhooku idempotentní.

Cron pro vypršení

Konfigurační stránka modulu zobrazuje URL cronu pro vypršení. Naplánujte jej, aby běžel každou minutu:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Použijte přesnou URL zobrazenou v back office vašeho PrestaShopu — token je generován při instalaci a je jiný pro každý obchod. Endpoint cronu ruší zastaralé nevyřízené objednávky Cost+ po nakonfigurovaném Checkout Expiry.

Ruční zachycení a refundace

  • Když je povoleno Manual Capture, platby jsou při checkoutu autorizovány a zachyceny, když je objednávka odeslána / označena jako dokončená
  • Pokud je zachycená objednávka zrušena, modul automaticky provede úplnou refundaci
  • Částečné refundace jsou zpracovávány přes dobropisy PrestaShop

4. Závěrečné kroky a testování

  1. Zkontrolujte všechny povolené platební metody
  2. Proveďte několik testovacích transakcí — úspěšných i neúspěšných — abyste se ujistili, že vše probíhá hladce
  3. Nakonfigurujte pokročilé chování jako manuální vs. automatické zachycení podle vašeho procesu plnění

Podpora

Potřebujete pomoc? Obraťte se na náš tým podpory na support@costplus.io.

On this page