Drupal Commerce

Integruokite Cost+ su savo Drupal Commerce parduotuve naudodami oficialų mokėjimo šliuzo modulį

Integruokite Cost+ kaip mokėjimo būdą savo Drupal Commerce parduotuvėje. Oficialus NoPayn Payment Gateway modulis naudoja mokėjimo puslapio procesą, todėl jokia kortelių informacija nepaliečia jūsų serverio — visiškai PCI DSS atitinkantis.

Būtinosios sąlygos

Aktyvi Cost+ prekybininko paskyra
Drupal 10 arba 11
Drupal Commerce 3.x
PHP 8.1 arba naujesnė
Administratoriaus prieiga prie jūsų Drupal svetainės

Palaikomi mokėjimo būdai

Credit / Debit Card — Visa, Mastercard ir daugiau
Apple Pay
Google Pay
Vipps / MobilePay

1. Įdiekite modulį

Nukopijuokite commerce_nopayn modulį į savo Drupal diegimą ir įjunkite jį:

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

Taip pat galite atsisiųsti modulį tiesiogiai iš GitHub saugyklos.

2. Pridėkite mokėjimo šliuzą

Eikite į Commerce -> Configuration -> Payment gateways (/admin/commerce/config/payment-gateways)
Paspauskite Add payment gateway
Pasirinkite NoPayn Payment Gateway kaip įskiepį

3. Sukonfigūruokite šliuzą

Įveskite šiuos nustatymus:

NoPayn API Key — jūsų prekybininko API raktas iš prekybininko portalo
Payment Methods — įjunkite arba išjunkite Credit Card, Apple Pay, Google Pay, Vipps MobilePay
Mode — nustatykite Test, kai naudojate API raktą iš testavimo svetainės, arba Live, kai naudojate produkcijos svetainės raktą

Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.

Neprivalomi nustatymai

Manual Capture — autorizuoti kreditinių kortelių mokėjimus be nedelsiant surinkimo (lėšos rezervuojamos, tada surenkamos, kai užsakymas įvykdomas)
Debug Logging — įjungti, kad visi API užklausų ir atsakymų duomenys būtų registruojami Drupal žurnale trikčių šalinimui

Paspauskite Save, kai baigsite.

4. Mokėjimo procesas

Sukonfigūravus, mokėjimo procesas veikia taip:

Klientas prideda prekes į krepšelį ir eina į atsiskaitymą
Mokėjimo žingsnyje rodomi įjungti Cost+ būdai kaip radijo mygtukai
Klientas pasirenka būdą ir patvirtina užsakymą
Modulis sukuria užsakymą per Cost+ API ir nukreipia į mokėjimo puslapį
Klientas atlieka mokėjimą Cost+ puslapyje
Klientas grįžta į parduotuvę — mokėjimas patikrinamas per API
Webhook iš Cost+ asinchroniškai patvirtina mokėjimo rezultatą

Mokėjimo sesijos baigiasi po 5 minučių pagal Cost+ standartus. Modulis taip pat siunčia detalizuotas užsakymo eilutes (produktus ir siuntimą) į Cost+ detaliam operacijų registravimui.

5. Webhook konfigūracija

Webhook URL automatiškai sugeneruojamas Drupal Commerce:

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

Pavyzdžiui: https://your-store.com/payment/notify/nopayn

Šis URL turi būti pasiekiamas iš interneto be autentifikacijos. Modulis visada patikrina mokėjimo būseną per API — niekada nepasitiki vien webhook turiniu.

Rankinis surinkimas

Kai rankinis surinkimas įjungtas kreditinėms kortelėms:

Kliento kortelė autorizuojama (lėšos rezervuojamos) atsiskaitymo metu
Surinkimas įvyksta automatiškai, kai užsakymas pereina į Fulfilled
Jei užsakymas atšaukiamas, autorizacija anuliuojama per webhook

Naudokite rankinį surinkimą, jei norite apmokestinti klientus tik kai jų užsakymas išsiunčiamas. Tai naudinga prekybininkams su ilgesniu vykdymo laiku.

Grąžinimai

Grąžinimus galima apdoroti tiesiogiai iš Commerce administravimo skydelio. Palaikomi tiek pilni, tiek daliniai grąžinimai.

Duomenų bazės lentelės

Modulis sukuria dvi lenteles sekimui:

Lentelė	Paskirtis
`nopayn_transactions`	Seka mokėjimo užsakymus, sukurtus su Cost+ API
`nopayn_refunds`	Registruoja grąžinimo operacijas audito tikslais

Pašalinimas

drush pmu commerce_nopayn -y
drush cr

Pašalinus modulį bus ištrintos nopayn_transactions ir nopayn_refunds lentelės. Įsitikinkite, kad eksportavote reikalingus duomenis prieš pašalinimą.

Testuokite ir paleiskite

Atlikite kelis testinius užsakymus, kad įsitikintumėte, jog viskas veikia sklandžiai. Nustatykite šliuzo Mode kaip Test ir patikrinkite tiek sėkmingus, tiek nesėkmingus mokėjimus prieš perjungdami į Live.

Palaikymas

Reikia pagalbos? Kreipkitės į mūsų palaikymo komandą adresu support@costplus.io.

On this page