Drupal Commerce
Integra Cost+ mal-ħanut Drupal Commerce tiegħek bl-użu tal-modulu uffiċjali tal-gateway tal-ħlas

Integra Cost+ bħala metodu ta' ħlas fil-ħanut Drupal Commerce tiegħek. Il-modulu uffiċjali NoPayn Payment Gateway juża l-flusso tal-Paġna ta' Ħlas Ospitata, għalhekk l-ebda data tal-karti ma tmiss is-server tiegħek — kompletament konformi mal-PCI DSS.
Prerekwiżiti
- Kont attiv ta' kummerċjant Cost+
- Drupal 10 jew 11
- Drupal Commerce 3.x
- PHP 8.1 jew aktar tard
- Aċċess ta' amministratur għas-sit Drupal tiegħek
Metodi ta' Ħlas Appoġġjati
- Credit / Debit Card — Visa, Mastercard, u aktar
- Apple Pay
- Google Pay
- Vipps / MobilePay
1. Installa l-Modulu
Ikkopja l-modulu commerce_nopayn fl-installazzjoni Drupal tiegħek u attivah:
cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush crTista' wkoll tniżżel il-modulu direttament mir-repożitorju ta' GitHub.
2. Żid Gateway tal-Ħlas
- Mur fuq Commerce → Configuration → Payment gateways (
/admin/commerce/config/payment-gateways) - Ikklikkja Add payment gateway
- Agħżel NoPayn Payment Gateway bħala l-plugin
3. Ikkonfigura l-Gateway
Daħħal is-settings li ġejjin:
- NoPayn API Key — Iċ-ċavetta API tal-kummerċjant tiegħek mill-Portal tal-Kummerċjant
- Payment Methods — Attiva jew diżattiva Credit Card, Apple Pay, Google Pay, Vipps MobilePay
- Mode — Issettja għal Test meta tuża ċavetta API minn website sandbox, jew Live meta tuża ċavetta ta' website tal-produzzjoni
Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.
Settings Opzjonali
- Manual Capture — Awtorizza ħlasijiet bil-karta ta' kreditu mingħajr capture immedjat (il-fondi jiġu riżervati, imbagħad maqbuda meta l-ordni tiġi ssodisfata)
- Debug Logging — Attiva biex tirreġistra t-talbiet u r-risponsi kollha tal-API fil-log ta' Drupal għas-soluzzjoni tal-problemi
Ikklikkja Save meta tlesti.
4. Flusso tal-Ħlas
Ladarba kkonfigurat, il-flusso tal-ħlas jaħdem hekk:
- Il-klijent iżid prodotti mal-karrettun u jkompli l-checkout
- Fil-pass tal-ħlas, il-metodi attivati ta' Cost+ jidhru bħala radio buttons
- Il-klijent jagħżel metodu u jikkonferma l-ordni
- Il-modulu joħloq ordni permezz tal-API ta' Cost+ u jirridirezzjona lejn il-paġna ta' ħlas ospitata
- Il-klijent jlesti l-ħlas fuq il-paġna ta' Cost+
- Il-klijent jirritorna lejn il-ħanut — il-ħlas jiġi vverifikat permezz tal-API
- Webhook minn Cost+ jikkonferma b'mod asinkronu r-riżultat tal-ħlas
Is-sessjonijiet tal-ħlas jiskadu wara 5 minuti skont l-istandards ta' Cost+. Il-modulu jibgħat ukoll linji dettaljati tal-ordni (prodotti u kunsinna) lil-Cost+ għal rekords dettaljati tat-tranżazzjonijiet.
5. Konfigurazzjoni tal-Webhook
L-URL tal-webhook tiġi ġġenerata awtomatikament minn Drupal Commerce:
https://your-store.com/payment/notify/{gateway_machine_name}Pereżempju: https://your-store.com/payment/notify/nopayn
Din l-URL trid tkun aċċessibbli mill-internet mingħajr awtentikazzjoni. Il-modulu dejjem jivverifika l-istatus tal-ħlas permezz tal-API — qatt ma jafda l-payload tal-webhook waħdu.
Capture Manwali
Meta l-capture manwali huwa attivat għall-karti ta' kreditu:
- Il-karta tal-klijent tiġi awtorizzata (fondi riżervati) waqt il-checkout
- Il-capture iseħħ awtomatikament meta l-ordni tgħaddi għal Fulfilled
- Jekk l-ordni tiġi kkanċellata, l-awtorizzazzjoni tiġi annullata permezz tal-webhook
Uża capture manwali jekk trid iċċarġja lill-klijenti biss meta l-ordni tagħhom tiġi kkonsenjata. Dan huwa utli għal kummerċjanti b'żminijiet itwal ta' eżekuzzjoni.
Rifużjonijiet
Ir-rifużjonijiet jistgħu jiġu pproċessati direttament mill-pannell tal-amministrazzjoni ta' Commerce. Kemm rifużjonijiet sħaħ u parzjali huma appoġġjati.
Tabelli tad-Database
Il-modulu joħloq żewġ tabelli għat-traċċar:
| Tabella | Skop |
|---|---|
nopayn_transactions | Itraċċa ordnijiet tal-ħlas maħluqa mal-API ta' Cost+ |
nopayn_refunds | Tirreġistra operazzjonijiet ta' rifużjoni għal skopijiet ta' awditjar |
Diżinstallazzjoni
drush pmu commerce_nopayn -y
drush crId-diżinstallazzjoni tal-modulu se tneħħi t-tabelli nopayn_transactions u nopayn_refunds. Kun żgur li tesportja kwalunkwe data li għandek bżonn qabel id-diżinstallazzjoni.
Ittestja u Mur Live
Agħmel ftit tranżazzjonijiet tat-test biex tiżgura li kollox jaħdem tajjeb. Issettja l-Modalità tal-gateway għal Test u ivverifika kemm ħlasijiet li jirnexxu u li jfallu qabel ma taqleb għal Live.
Appoġġ
Għandek bżonn l-għajnuna? Ikkuntattja t-tim tal-appoġġ tagħna fuq support@costplus.io.