Drupal Commerce

Integrálja a Cost+-t fizetési módként Drupal Commerce áruházába. A hivatalos NoPayn Payment Gateway modul a tárolt fizetési oldal folyamatát használja, így kártyaadatok nem érintik az Ön szerverét — teljes PCI DSS megfelelőséggel.

Előfeltételek

• Aktív Cost+ kereskedői fiók
• Drupal 10 vagy 11
• Drupal Commerce 3.x
• PHP 8.1 vagy újabb
• Adminisztrátori hozzáférés a Drupal oldalhoz

Támogatott fizetési módok

• Hitel- / Betéti kártya — Visa, Mastercard és több
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. A modul telepítése

Másolja a commerce_nopayn modult a Drupal telepítésbe és engedélyezze:

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

2. Fizetési átjáró hozzáadása

1. Navigáljon a Commerce → Konfiguráció → Fizetési átjárók (/admin/commerce/config/payment-gateways) oldalra
2. Kattintson a Fizetési átjáró hozzáadása gombra
3. Válassza a NoPayn Payment Gateway-t bővítményként

3. Az átjáró konfigurálása

Adja meg az alábbi beállításokat:

• NoPayn API Key — Az Ön kereskedői API-kulcsa a kereskedői portálból
• Fizetési módok — Hitelkártya, Apple Pay, Google Pay, Vipps MobilePay engedélyezése vagy letiltása
• Mód — Állítsa Teszt értékre sandbox weboldal API-kulcs használatakor, vagy Éles értékre éles weboldal kulcs használatakor

Opcionális beállítások

• Manuális rögzítés — Hitelkártyás fizetések engedélyezése azonnali rögzítés nélkül (az összeg foglalásra kerül, majd rögzítés a rendelés teljesítésekor)
• Hibakeresési naplózás — Engedélyezze az összes API-kérés és válasz naplózásához a Drupal naplóba hibaelhárítás céljából

Kattintson a Mentés gombra, amikor kész.

4. Fizetési folyamat

A konfigurálás után a fizetési folyamat a következőképpen működik:

1. Az ügyfél termékeket ad a kosárba és a pénztárhoz lép
2. A fizetési lépésnél az engedélyezett Cost+ módok rádiógombokként jelennek meg
3. Az ügyfél kiválaszt egy módot és megerősíti a rendelést
4. A modul rendelést hoz létre a Cost+ API-n keresztül és átirányít a tárolt fizetési oldalra
5. Az ügyfél befejezi a fizetést a Cost+ oldalon
6. Az ügyfél visszatér az áruházba — a fizetés API-n keresztül ellenőrzésre kerül
7. A Cost+ webhookja aszinkron módon megerősíti a fizetés eredményét

5. Webhook konfiguráció

A webhook URL-t a Drupal Commerce automatikusan generálja:

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

Például: https://your-store.com/payment/notify/nopayn

Ennek az URL-nek az internetről hitelesítés nélkül elérhetőnek kell lennie. A modul mindig az API-n keresztül ellenőrzi a fizetés állapotát — soha nem bízik kizárólag a webhook adatcsomagban.

Manuális rögzítés

Ha a manuális rögzítés engedélyezve van a hitelkártyáknál:

1. Az ügyfél kártyája engedélyezésre kerül (összeg foglalása) a pénztárnál
2. A rögzítés automatikusan történik, amikor a rendelés Teljesített állapotra vált
3. Ha a rendelés törlésre kerül, az engedélyezés érvénytelenítésre kerül a webhookon keresztül

Visszatérítések

A visszatérítések közvetlenül a Commerce adminisztrációs panelből dolgozhatók fel. Mind a teljes, mind a részleges visszatérítések támogatottak.

Adatbázis táblák

A modul két táblát hoz létre a nyomon követéshez:

Eltávolítás

drush pmu commerce_nopayn -y
drush cr

Tesztelés és indítás

Végezzen néhány teszttranzakciót, hogy meggyőződjön minden zökkenőmentesen működik. Állítsa az átjáró Módját Teszt értékre, és ellenőrizze mind a sikeres, mind a sikertelen fizetéseket, mielőtt Éles módra váltana.

Támogatás

Segítségre van szüksége? Forduljon ügyfélszolgálatunkhoz: support@costplus.io.