Drupal Commerce
Integrujte Cost+ s vasim obchodom Drupal Commerce pomocou oficialneho modulu platobnej brany

Integrujte Cost+ ako platobnu metodu vo vasom obchode Drupal Commerce. Oficialny modul NoPayn Payment Gateway pouziva proces hostovanej platobnej stranky, takze ziadne udaje kariet sa nedotknu vasho servera -- plne kompatibilny s PCI DSS.
Predpoklady
- Aktivny ucet obchodnika Cost+
- Drupal 10 alebo 11
- Drupal Commerce 3.x
- PHP 8.1 alebo novsi
- Administratorsky pristup k vasej stranke Drupal
Podporovane platobne metody
- Credit / Debit Card -- Visa, Mastercard a dalsie
- Apple Pay
- Google Pay
- Vipps / MobilePay
1. Instalacia modulu
Skopiujte modul commerce_nopayn do vasej instalacie Drupal a aktivujte ho:
cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush crModul si mozete tiez stiahnut priamo z GitHub repozitara.
2. Pridanie platobnej brany
- Prejdite na Commerce -> Configuration -> Payment gateways (
/admin/commerce/config/payment-gateways) - Kliknite na Add payment gateway
- Vyberte NoPayn Payment Gateway ako plugin
3. Konfiguracia brany
Zadajte nasledujuce nastavenia:
- NoPayn API Key -- Vas obchodnicky API kluc z obchodneho portalu
- Payment Methods -- Aktivacia alebo deaktivacia Credit Card, Apple Pay, Google Pay, Vipps MobilePay
- Mode -- Nastavte na Test pri pouziti API kluca zo sandbox webovej stranky, alebo Live pri pouziti kluca produkcnej webovej stranky
Aktivujte len tie platobne metody, pre ktore ste boli schvaleni a dostali potvrdenie.
Volitelne nastavenia
- Manual Capture -- Autorizacia platieb kartou bez okamziteho zachytenia (prostriedky su rezervovane, potom zachytene pri vybaveni objednavky)
- Debug Logging -- Aktivacia logovania vsetkych API poziadaviek a odpovedi do logu Drupal na ucely riesenia problemov
Ked mate hotovo, kliknite na Save.
4. Platobny proces
Po konfiguracii platobny proces funguje nasledovne:
- Zakaznik prida produkty do kosika a pokracuje k pokladni
- V kroku platby sa zobrazia aktivovane metody Cost+ ako radio tlacidla
- Zakaznik si vyberie metodu a potvrdi objednavku
- Modul vytvori objednavku cez Cost+ API a presmeruje na hostovanu platobnu stranku
- Zakaznik dokonci platbu na stranke Cost+
- Zakaznik sa vrati do obchodu -- platba sa overi cez API
- Webhook z Cost+ asynchronne potvrdi vysledok platby
Platobne relacie vyprsia po 5 minutach podla standardov Cost+. Modul tiez odosiela polozky objednavky (produkty a dopravu) na Cost+ pre podrobne zaznamy transakcii.
5. Konfiguracia webhookov
Webhook URL je automaticky generovana Drupal Commerce:
https://your-store.com/payment/notify/{gateway_machine_name}Napriklad: https://your-store.com/payment/notify/nopayn
Tato URL musi byt pristupna z internetu bez autentifikacie. Modul vzdy overuje stav platby cez API -- nikdy neveri len payloadu webhooku.
Manualne zachytenie
Ked je manualne zachytenie aktivovane pre kreditne karty:
- Karta zakaznika je autorizovana (prostriedky rezervovane) pocas pokladne
- Zachytenie nastane automaticky, ked objednavka prejde do stavu Fulfilled
- Ak je objednavka zrusena, autorizacia je anulovana cez webhook
Pouzite manualne zachytenie, ak chcete ucastovat zakaznikov az pri odoslani ich objednavky. Toto je uzitocne pre obchodnikov s dlhsimi casmi plnenia.
Vratenie platieb
Vratenia platieb je mozne spracovat priamo z administratorskeho panelu Commerce. Podporovane su uplne aj ciastocne vratenia.
Databazove tabulky
Modul vytvara dve tabulky na sledovanie:
| Tabulka | Ucel |
|---|---|
nopayn_transactions | Sledovanie platobnych objednavok vytvorenych s Cost+ API |
nopayn_refunds | Zaznamy operacii vratenia pre ucely auditu |
Odinstalovanie
drush pmu commerce_nopayn -y
drush crOdinstalovanie modulu zrusi 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. Nastavte branu Mode na Test a overte uspesne aj neuspesne platby pred prepnutim na Live.
Podpora
Potrebujete pomoc? Kontaktujte nas tym podpory na support@costplus.io.