Cost+Docs

OpenCart

Integrujte Cost+ s vaším OpenCart obchodem (4.x a 3.x / ocStore 3)

OpenCart

Integrujte Cost+ jako platební metodu do vašeho OpenCart obchodu. Oficiální rozšíření NoPayn Payment Gateway je k dispozici pro OpenCart 4 a OpenCart 3 / ocStore 3.

Předpoklady

  • Aktivní obchodní účet Cost+
  • OpenCart 4.0.0.0 nebo novější
  • PHP 8.0 nebo novější
  • Administrátorský přístup k dashboardu OpenCart
  • Aktivní obchodní účet Cost+
  • ocStore 3.0.x nebo OpenCart 3.0.3.x
  • PHP 7.4 nebo novější
  • Administrátorský přístup k dashboardu OpenCart

Podporované platební metody

  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Nainstalujte rozšíření

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

  1. Stáhněte nejnovější .ocmod.zip release z GitHubu
  2. V administraci OpenCart přejděte na Extensions → Installer
  3. Nahrajte soubor .ocmod.zip
  4. Přejděte na Extensions → Extensions → Payment
  5. Najděte NoPayn Payment Gateway a klikněte na Install, poté na Edit

Metoda B: Ruční nahrání

  1. Stáhněte nebo naklonujte repozitář
  2. Zkopírujte obsah složky upload/ do kořenového adresáře OpenCart
  3. Přejděte na Extensions → Extensions → Payment
  4. Najděte NoPayn Payment Gateway a klikněte na Install, poté na Edit

Architektura

OpenCart 3 používá vícenásobné rozšíření:

  • NoPayn - Global Settings — sdílená konfigurace (API klíč, stavy objednávek, dostupnost metod, manuální zachycení, ladící logování)
  • NoPayn - Card Payments — platba kartou při checkoutu
  • NoPayn - Apple Pay / Google Pay — checkout peněženkou (pokud je povolena pouze jedna peněženka, popisek se automaticky přizpůsobí)
  • NoPayn - Vipps MobilePay — checkout Vipps/MobilePay
  • NoPayn - Swish — checkout Swish

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

  1. Stáhněte .ocmod.zip asset z nejnovějšího GitHub release

Použijte .ocmod.zip asset z release — ne GitHubem automaticky generované stažení „Source code", které obsahuje strukturu repozitáře, nikoli instalační layout.

  1. V administraci přejděte na Extensions → Installer
  2. Nahrajte soubor .ocmod.zip
  3. Přejděte na Extensions → Extensions → Payments
  4. Nejprve nainstalujte NoPayn - Global Settings
  5. Otevřete NoPayn - Global Settings a nakonfigurujte:
    • API klíč
    • Stavy objednávek pro dokončené, čekající a zrušené
    • Dostupné platební metody schválené pro váš obchodní účet
    • Volitelně: manuální zachycení karet
    • Volitelně: ladící logování
  6. Nainstalujte checkout moduly, které chcete zpřístupnit:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Pro každý checkout modul nastavte: Status, Geo Zone a Sort Order

Metoda B: Ruční nahrání

  1. Stáhněte nebo naklonujte repozitář
  2. Zkopírujte obsah složky upload/ do kořenového adresáře obchodu
  3. Přejděte na Extensions → Extensions → Payments
  4. Postupujte stejně jako u metody A (nejprve Global Settings, poté checkout moduly)

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 nastavení NoPayn Payment Gateway zadejte svůj API Key do příslušného pole.

V NoPayn - Global Settings zadejte svůj API Key do příslušného pole. API klíč je sdílený mezi všemi checkout moduly — stačí ho zadat jednou.

3. Nakonfigurujte nastavení plateb

  1. Povolte platební metody, pro které jste byli schváleni
  2. Nastavte preferované stavy objednávek pro dokončené, čekající a zrušené platby
  3. Volitelně omezte platby podle Geo Zone
  4. Nastavte Status na Enabled
  5. Klikněte na Save

Globální nastavení

NoPayn - Global Settings uchovává veškerou sdílenou konfiguraci:

NastaveníPopis
API KeyVáš NoPayn API klíč
Order StatusesMapování stavů pro dokončené, čekající a zrušené objednávky
Method AvailabilityKteré platební metody jsou schváleny pro váš obchodní účet
Manual CaptureAutorizovat platby kartou — zachytit později
Debug LoggingPovolit podrobné logování pro řešení problémů

Nastavení checkout modulů

Každý checkout modul má vlastní nastavení pro obchod:

NastaveníPopis
StatusPovolit nebo zakázat tuto platební metodu při checkoutu
Geo ZoneOmezit na specifické geografické zóny
Sort OrderPořadí zobrazení na stránce 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 NoPayn
  3. Po platbě se zákazník vrátí a stav objednávky je automaticky aktualizován
  4. NoPayn odešle webhook pro asynchronní potvrzení stavu

Rozšíření používá hostovanou platební stránku Cost+, což znamená, že zákazníci jsou přesměrováni na bezpečný platební formulář. Na vašem serveru se nezpracovávají žádná citlivá data karet.

Každý checkout modul je samostatné platební rozšíření OpenCart, které dává zákazníkům oddělené výběrové možnosti při checkoutu (např. „Card Payments", „Apple Pay & Google Pay").

  1. Zákazník vybere popisek platební metody při checkoutu (např. Card Payments)
  2. Rozšíření vytvoří hostovanou platební objednávku NoPayn
  3. Zákazník je přesměrován na bezpečnou platební stránku NoPayn
  4. Po platbě se zákazník vrátí a stav objednávky je automaticky aktualizován
  5. NoPayn odešle webhook pro asynchronní potvrzení stavu

Modul Apple Pay / Google Pay odesílá obě metody v jedné transakci, takže hostovaná stránka NoPayn může nabídnout obě možnosti peněženky v jednom toku.

Upgrade z v1.0.0 na v2.0.0

Verze 1.0.0 používala jednu checkout metodu nazvanou „NoPayn Checkout". Verze 2.0.0 přechází na samostatné checkout moduly pro každou platební metodu. Při upgradu:

  1. Nahrajte nový balíček
  2. Vaše stávající položka „NoPayn Checkout" se stane NoPayn - Global Settings
  3. Zkontrolujte a uložte globální nastavení
  4. Nainstalujte a povolte nové checkout moduly, které chcete zákazníkům zobrazit

4. 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.

modified eCommerce

Integrujte Cost+ s vaším modified eCommerce obchodem pomocí MMLC modulu

Shopware

Integrujte Cost+ s vaším Shopware 6 obchodem pomocí oficiálního platebního pluginu

On this page

PředpokladyPodporované platební metody1. Nainstalujte rozšířeníMetoda A: Nahrání přes administrační panel (doporučeno)Metoda B: Ruční nahráníArchitekturaMetoda A: Nahrání přes administrační panel (doporučeno)Metoda B: Ruční nahrání2. Zadejte API přihlašovací údaje3. Nakonfigurujte nastavení platebGlobální nastaveníNastavení checkout modulůPlatební tokUpgrade z v1.0.0 na v2.0.04. Otestujte a spusťtePodpora