Drupal Commerce

Integreerige Cost+ makseviisina oma Drupal Commerce poega. Ametlik NoPayn Payment Gateway moodul kasutab hostitud makselehe voogu, nii et kaardiandmed ei puutu teie serverit — täielikult PCI DSS-iga ühilduv.

Eeldused

Aktiivne Cost+ kaupmehe konto
Drupal 10 või 11
Drupal Commerce 3.x
PHP 8.1 või uuem
Administraatori juurdepääs teie Drupal saidile

Toetatud makseviisid

Credit / Debit Card — Visa, Mastercard ja muud
Apple Pay
Google Pay
Vipps / MobilePay

1. Paigaldage moodul

Kopeerige moodul commerce_nopayn oma Drupal paigaldusse ja lubage see:

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

Saate mooduli alla laadida ka otse GitHub hoidlast.

2. Lisage makselüüs

Navigeerige jaotisse Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
Klõpsake Add payment gateway
Valige pluginaks NoPayn Payment Gateway

3. Seadistage lüüs

Sisestage järgmised seaded:

NoPayn API Key — Teie kaupmehe API võti kaupmehe portaalist
Payment Methods — Lubage või keelake Credit Card, Apple Pay, Google Pay, Vipps MobilePay
Mode — Määrake Test, kui kasutate liivakasti veebilehe API võtit, või Live, kui kasutate tootmise veebilehe võtit

Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.

Valikulised seaded

Manual Capture — Autoriseerige krediitkaardimaksed ilma kohese hõivamiseta (vahendid reserveeritakse, seejärel hõivatakse tellimuse täitmisel)
Debug Logging — Lubage kõigi API päringute ja vastuste logimine Drupal logisse veaotsinguks

Klõpsake Save, kui olete valmis.

4. Maksevoog

Pärast seadistamist töötab maksevoog järgmiselt:

Klient lisab tooted ostukorvi ja jätkab kassasse
Makse sammul kuvatakse lubatud Cost+ meetodid raadionuppudena
Klient valib meetodi ja kinnitab tellimuse
Moodul loob tellimuse Cost+ API kaudu ja suunab hostitud makselehele
Klient teostab makse Cost+ lehel
Klient naaseb poodi — makse kinnitatakse API kaudu
Cost+ veebihaak kinnitab asünkroonselt makse tulemuse

Makseseansid aeguvad 5 minuti pärast Cost+ standardite kohaselt. Moodul saadab ka spetsifiseeritud tellimuse read (tooted ja saatmine) Cost+-ile üksikasjalike tehingukirjete jaoks.

5. Veebihaagi seadistamine

Veebihaagi URL genereeritakse Drupal Commerce poolt automaatselt:

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

Näiteks: https://your-store.com/payment/notify/nopayn

See URL peab olema internetist ligipääsetav ilma autentimiseta. Moodul kontrollib alati makse olekut API kaudu — see ei usalda kunagi ainult veebihaagi andmeid.

Käsitsi hõivamine

Kui käsitsi hõivamine on krediitkaartide jaoks lubatud:

Kliendi kaart autoriseeritakse (vahendid reserveeritakse) kassas
Hõivamine toimub automaatselt, kui tellimus liigub olekusse Fulfilled
Kui tellimus tühistatakse, tühistatakse autoriseerimine veebihaagi kaudu

Kasutage käsitsi hõivamist, kui soovite klientidelt tasu võtta alles tellimuse saatmisel. See on kasulik pikemate täitmisaegadega kaupmeestele.

Tagasimaksed

Tagasimakseid saab töödelda otse Commerce halduspaneelist. Toetatud on nii täielikud kui osalised tagasimaksed.

Andmebaasi tabelid

Moodul loob jälgimiseks kaks tabelit:

Tabel	Otstarve
`nopayn_transactions`	Jälgib Cost+ API kaudu loodud maksetellimusi
`nopayn_refunds`	Salvestab tagasimakse toimingud auditeerimise eesmärgil

Desinstallimine

drush pmu commerce_nopayn -y
drush cr

Mooduli desinstallimine kustutab tabelid nopayn_transactions ja nopayn_refunds. Veenduge, et ekspordite vajalikud andmed enne desinstallimist.

Testige ja käivitage

Tehke mõned testtehingud, et veenduda kõige sujuvas toimimises. Määrake lüüsi Mode olekusse Test ja kontrollige nii edukaid kui ebaõnnestunud makseid enne Live režiimile lülitumist.

Tugi

Vajate abi? Võtke ühendust meie tugimeeskonnaga aadressil support@costplus.io.

On this page