Cost+Docs

Drupal Commerce

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

Drupal Commerce

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 cr

Modul možete također preuzeti izravno s GitHub repozitorija.

2. Dodajte platni pristupnik

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

  1. Kupac dodaje proizvode u košaricu i nastavlja na blagajnu
  2. Na koraku plaćanja prikazani su omogućeni Cost+ načini kao radio gumbi
  3. Kupac odabire način i potvrđuje narudžbu
  4. Modul stvara narudžbu putem Cost+ API-ja i preusmjerava na hosted stranicu za plaćanje
  5. Kupac dovršava plaćanje na Cost+ stranici
  6. Kupac se vraća u trgovinu — plaćanje se provjerava putem API-ja
  7. 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:

  1. Kartica kupca se autorizira (sredstva se rezerviraju) tijekom blagajne
  2. Naplata se vrši automatski kada narudžba prijeđe u status Fulfilled
  3. 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:

TablicaSvrha
nopayn_transactionsPrati narudžbe plaćanja stvorene putem Cost+ API-ja
nopayn_refundsBilježi operacije povrata za potrebe revizije

Deinstalacija

drush pmu commerce_nopayn -y
drush cr

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

On this page