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

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 crModul lahko prenesete tudi neposredno iz GitHub repozitorija.
2. Dodajte plačilni prehod
- Pojdite na Commerce → Konfiguracija → Plačilni prehodi (
/admin/commerce/config/payment-gateways) - Kliknite Dodaj plačilni prehod
- 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:
- Stranka doda izdelke v košarico in nadaljuje na blagajno
- Na koraku plačila so omogočene metode Cost+ prikazane kot radijski gumbi
- Stranka izbere metodo in potrdi naročilo
- Modul ustvari naročilo prek Cost+ API in preusmeri na gostovano plačilno stran
- Stranka dokonča plačilo na strani Cost+
- Stranka se vrne v trgovino — plačilo je preverjeno prek API-ja
- 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:
- Kartica stranke je avtorizirana (sredstva rezervirana) med blagajno
- Zajem se izvede samodejno, ko naročilo preide v status Izpolnjeno
- Č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:
| Tabela | Namen |
|---|---|
nopayn_transactions | Sledi plačilnim naročilom, ustvarjenim s Cost+ API |
nopayn_refunds | Beleži operacije vračil za revizijske namene |
Odstranitev
drush pmu commerce_nopayn -y
drush crOdstranitev 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.