Cost+Docs

Drupal Commerce

Integrirajte Cost+ s svojo Drupal Commerce trgovino z uradnim modulom plačilnega prehoda

Drupal Commerce

Integrirajte Cost+ kot plačilno metodo v svojo Drupal Commerce trgovino. Uradni modul NoPayn Payment Gateway uporablja tok gostovane plačilne strani, tako da nobeni kartični podatki ne pridejo v stik z vašim strežnikom — v celoti skladen s PCI DSS.

Predpogoji

  • Aktiven trgovski račun Cost+
  • Drupal 10 ali 11
  • Drupal Commerce 3.x
  • PHP 8.1 ali novejši
  • Skrbniški dostop do vašega Drupal spletnega mesta

Podprte plačilne metode

  • Kreditna / debetna kartica — Visa, Mastercard in druge
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay

1. Namestite modul

Kopirajte modul commerce_nopayn v vašo Drupal namestitev in ga omogočite:

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

Modul lahko prenesete tudi neposredno iz GitHub repozitorija.

2. Dodajte plačilni prehod

  1. Pojdite na Commerce → Konfiguracija → Plačilni prehodi (/admin/commerce/config/payment-gateways)
  2. Kliknite Dodaj plačilni prehod
  3. Izberite NoPayn Payment Gateway kot vtičnik

3. Konfigurirajte prehod

Vnesite naslednje nastavitve:

  • NoPayn API Key — Vaš trgovski API ključ iz portala trgovca
  • Plačilne metode — Omogočite ali onemogočite kreditno kartico, Apple Pay, Google Pay, Vipps MobilePay
  • Način — Nastavite na Test pri uporabi API ključa spletnega mesta peskovnika ali Produkcija pri uporabi produkcijskega ključa spletnega mesta

Aktivirajte samo plačilne metode, za katere ste bili odobreni in ste prejeli potrditev.

Neobvezne nastavitve

  • Ročni zajem — Avtorizirajte kartična plačila brez takojšnjega zajema (sredstva so rezervirana, nato zajeta ob izpolnitvi naročila)
  • Beleženje za odpravljanje napak — Omogočite za beleženje vseh API zahtev in odgovorov v Drupal dnevnik za odpravljanje napak

Kliknite Shrani, ko ste končali.

4. Tok plačila

Ko je konfigurirano, tok plačila deluje na naslednji način:

  1. Stranka doda izdelke v košarico in nadaljuje na blagajno
  2. Na koraku plačila so omogočene metode Cost+ prikazane kot radijski gumbi
  3. Stranka izbere metodo in potrdi naročilo
  4. Modul ustvari naročilo prek Cost+ API in preusmeri na gostovano plačilno stran
  5. Stranka dokonča plačilo na strani Cost+
  6. Stranka se vrne v trgovino — plačilo je preverjeno prek API-ja
  7. Webhook od Cost+ asinhrono potrdi rezultat plačila

Plačilne seje potečejo po 5 minutah po standardih Cost+. Modul pošlje tudi podrobne postavke naročila (izdelke in poštnino) v Cost+ za podrobne zapise transakcij.

5. Konfiguracija webhook-a

URL webhook-a je samodejno generiran s strani Drupal Commerce:

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

Na primer: https://your-store.com/payment/notify/nopayn

Ta URL mora biti dostopen z interneta brez avtentikacije. Modul vedno preveri status plačila prek API-ja — nikoli ne zaupa samo koristnim podatkom webhook-a.

Ročni zajem

Ko je ročni zajem omogočen za kreditne kartice:

  1. Kartica stranke je avtorizirana (sredstva rezervirana) med blagajno
  2. Zajem se izvede samodejno, ko naročilo preide v status Izpolnjeno
  3. Če je naročilo preklicano, je avtorizacija razveljavljena prek webhook-a

Uporabite ročni zajem, če želite strankam zaračunati šele, ko je njihovo naročilo odposlano. To je koristno za trgovce z daljšimi časi izpolnjevanja.

Vračila

Vračila je mogoče obdelati neposredno iz skrbniške plošče Commerce. Podprta so tako celotna kot delna vračila.

Tabele podatkovne baze

Modul ustvari dve tabeli za sledenje:

TabelaNamen
nopayn_transactionsSledi plačilnim naročilom, ustvarjenim s Cost+ API
nopayn_refundsBeleži operacije vračil za revizijske namene

Odstranitev

drush pmu commerce_nopayn -y
drush cr

Odstranitev modula bo izbrisala tabeli nopayn_transactions in nopayn_refunds. Poskrbite, da izvozite vse potrebne podatke pred odstranitvijo.

Testirajte in zaženite

Izvedite nekaj testnih transakcij, da zagotovite nemoteno delovanje. Nastavite način prehoda na Test in preverite tako uspešna kot neuspešna plačila pred prehodom na Produkcija.

Podpora

Potrebujete pomoč? Obrnite se na našo ekipo za podporo na support@costplus.io.

On this page