Cost+Docs

Drupal Commerce

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

Drupal Commerce

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 cr

Modul si mozete tiez stiahnut priamo z GitHub repozitara.

2. Pridanie platobnej brany

  1. Prejdite na Commerce -> Configuration -> Payment gateways (/admin/commerce/config/payment-gateways)
  2. Kliknite na Add payment gateway
  3. 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:

  1. Zakaznik prida produkty do kosika a pokracuje k pokladni
  2. V kroku platby sa zobrazia aktivovane metody Cost+ ako radio tlacidla
  3. Zakaznik si vyberie metodu a potvrdi objednavku
  4. Modul vytvori objednavku cez Cost+ API a presmeruje na hostovanu platobnu stranku
  5. Zakaznik dokonci platbu na stranke Cost+
  6. Zakaznik sa vrati do obchodu -- platba sa overi cez API
  7. 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:

  1. Karta zakaznika je autorizovana (prostriedky rezervovane) pocas pokladne
  2. Zachytenie nastane automaticky, ked objednavka prejde do stavu Fulfilled
  3. 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:

TabulkaUcel
nopayn_transactionsSledovanie platobnych objednavok vytvorenych s Cost+ API
nopayn_refundsZaznamy operacii vratenia pre ucely auditu

Odinstalovanie

drush pmu commerce_nopayn -y
drush cr

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

On this page