Drupal Commerce

Integrujte Cost+ jako platební metodu do vašeho Drupal Commerce obchodu. Oficiální modul NoPayn Payment Gateway 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+
• Drupal 10 nebo 11
• Drupal Commerce 3.x
• PHP 8.1 nebo novější
• Administrátorský přístup k vašemu Drupal webu

Podporované platební metody

• Credit / Debit Card — Visa, Mastercard a další
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Nainstalujte modul

Zkopírujte modul commerce_nopayn do vaší Drupal instalace a povolte ho:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Přidejte platební bránu

1. Přejděte na Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
2. Klikněte na Add payment gateway
3. Vyberte NoPayn Payment Gateway jako plugin

3. Nakonfigurujte bránu

Zadejte následující nastavení:

• NoPayn API Key — Váš obchodní API klíč z obchodního portálu
• Payment Methods — Povolte nebo zakažte Credit Card, Apple Pay, Google Pay, Vipps MobilePay
• Mode — Nastavte na Test při použití API klíče ze sandbox webu, nebo Live při použití klíče produkčního webu

Volitelná nastavení

• Manual Capture — Autorizujte platby kartou bez okamžitého zachycení (prostředky jsou rezervovány a poté zachyceny při plnění objednávky)
• Debug Logging — Povolte pro logování všech API požadavků a odpovědí do logu Drupal pro řešení problémů

Klikněte na Save po dokončení.

4. Platební tok

Po konfiguraci platební tok funguje následovně:

1. Zákazník přidá produkty do košíku a přejde k checkoutu
2. V kroku platby se zobrazí povolené metody Cost+ jako výběrová tlačítka
3. Zákazník vybere metodu a potvrdí objednávku
4. Modul vytvoří objednávku přes API Cost+ a přesměruje na hostovanou platební stránku
5. Zákazník dokončí platbu na stránce Cost+
6. Zákazník se vrátí do obchodu — platba je ověřena přes API
7. Webhook z Cost+ asynchronně potvrdí výsledek platby

5. Konfigurace webhooku

Webhook URL je automaticky generována Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

Například: https://your-store.com/payment/notify/nopayn

Tato URL musí být přístupná z internetu bez autentizace. Modul vždy ověří stav platby přes API — nikdy nevěří samotnému webhookovému payloadu.

Manuální zachycení

Když je manuální zachycení povoleno pro karty:

1. Karta zákazníka je autorizována (prostředky rezervovány) během checkoutu
2. Zachycení proběhne automaticky, když objednávka přejde do stavu Fulfilled
3. Pokud je objednávka zrušena, autorizace je zrušena (void) prostřednictvím webhooku

Refundace

Refundace lze zpracovat přímo z administračního panelu Commerce. Podporovány jsou úplné i částečné refundace.

Databázové tabulky

Modul vytváří dvě tabulky pro sledování:

Odinstalace

drush pmu commerce_nopayn -y
drush cr

Otestujte a spusťte

Proveďte několik testovacích transakcí, abyste se ujistili, že vše funguje hladce. Nastavte Mode brány na Test a ověřte jak úspěšné, tak neúspěšné platby před přepnutím na Live.

Podpora

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