Drupal Commerce
Integrirajte Cost+ sa svojom Drupal Commerce trgovinom koristeći službeni modul za platni pristupnik

Integrirajte Cost+ kao način plaćanja u svojoj Drupal Commerce trgovini. Službeni modul NoPayn Payment Gateway koristi tijek hosted stranice za plaćanje, tako da nikakvi podaci kartica ne dodiruju vaš poslužitelj — potpuno usklađen s PCI DSS standardom.
Preduvjeti
- Aktivan Cost+ trgovački račun
- Drupal 10 ili 11
- Drupal Commerce 3.x
- PHP 8.1 ili noviji
- Administratorski pristup vašoj Drupal stranici
Podržani načini plaćanja
- Credit / Debit Card — Visa, Mastercard i druge
- Apple Pay
- Google Pay
- Vipps / MobilePay
1. Instalirajte modul
Kopirajte modul commerce_nopayn u vašu Drupal instalaciju i omogućite ga:
cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush crModul možete također preuzeti izravno s GitHub repozitorija.
2. Dodajte platni pristupnik
- Idite na Commerce → Configuration → Payment gateways (
/admin/commerce/config/payment-gateways) - Kliknite Add payment gateway
- Odaberite NoPayn Payment Gateway kao dodatak
3. Konfigurirajte pristupnik
Unesite sljedeće postavke:
- NoPayn API Key — Vaš trgovački API ključ iz portala trgovca
- Payment Methods — Omogućite ili onemogućite Credit Card, Apple Pay, Google Pay, Vipps MobilePay
- Mode — Postavite na Test kada koristite API ključ sandbox web stranice, ili Live kada koristite ključ produkcijske web stranice
Aktivirajte samo one načine plaćanja za koje ste odobreni i za koje ste primili potvrdu.
Neobavezne postavke
- Manual Capture — Autorizirajte plaćanja karticama bez trenutne naplate (sredstva se rezerviraju, zatim naplaćuju kada se narudžba ispuni)
- Debug Logging — Omogućite za zapisivanje svih API zahtjeva i odgovora u Drupal zapisnik za rješavanje problema
Kliknite Save kada završite.
4. Tijek plaćanja
Nakon konfiguracije, tijek plaćanja funkcionira na sljedeći način:
- Kupac dodaje proizvode u košaricu i nastavlja na blagajnu
- Na koraku plaćanja prikazani su omogućeni Cost+ načini kao radio gumbi
- Kupac odabire način i potvrđuje narudžbu
- Modul stvara narudžbu putem Cost+ API-ja i preusmjerava na hosted stranicu za plaćanje
- Kupac dovršava plaćanje na Cost+ stranici
- Kupac se vraća u trgovinu — plaćanje se provjerava putem API-ja
- Webhook od Cost+ asinkrono potvrđuje rezultat plaćanja
Sesije plaćanja istječu nakon 5 minuta prema Cost+ standardima. Modul također šalje raščlanjene stavke narudžbe (proizvode i dostavu) na Cost+ za detaljne zapise transakcija.
5. Konfiguracija webhookova
Webhook URL automatski generira Drupal Commerce:
https://your-store.com/payment/notify/{gateway_machine_name}Na primjer: https://your-store.com/payment/notify/nopayn
Ovaj URL mora biti dostupan s interneta bez autentifikacije. Modul uvijek provjerava status plaćanja putem API-ja — nikada ne vjeruje samo webhook podacima.
Ručna naplata
Kada je ručna naplata omogućena za kreditne kartice:
- Kartica kupca se autorizira (sredstva se rezerviraju) tijekom blagajne
- Naplata se vrši automatski kada narudžba prijeđe u status Fulfilled
- Ako se narudžba poništi, autorizacija se poništava putem webhooka
Koristite ručnu naplatu ako želite naplatiti kupcima tek kada se njihova narudžba pošalje. Ovo je korisno za trgovce s duljim vremenima ispunjenja.
Povrati
Povrati se mogu obraditi izravno iz Commerce administratorske ploče. Podržani su i potpuni i djelomični povrati.
Tablice baze podataka
Modul stvara dvije tablice za praćenje:
| Tablica | Svrha |
|---|---|
nopayn_transactions | Prati narudžbe plaćanja stvorene putem Cost+ API-ja |
nopayn_refunds | Bilježi operacije povrata za potrebe revizije |
Deinstalacija
drush pmu commerce_nopayn -y
drush crDeinstalacija modula uklonit će tablice nopayn_transactions i nopayn_refunds. Pobrinite se da izvezete sve podatke koji su vam potrebni prije deinstalacije.
Testirajte i pokrenite
Napravite nekoliko testnih transakcija kako biste osigurali da sve radi glatko. Postavite Mode pristupnika na Test i provjerite i uspješna i neuspjela plaćanja prije prebacivanja na Live.
Podrška
Trebate pomoć? Obratite se našem timu za podršku na support@costplus.io.