Cost+Docs

Drupal Commerce

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

Drupal Commerce

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 cr

Tista' wkoll tniżżel il-modulu direttament mir-repożitorju ta' GitHub.

2. Żid Gateway tal-Ħlas

  1. Mur fuq Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
  2. Ikklikkja Add payment gateway
  3. 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:

  1. Il-klijent iżid prodotti mal-karrettun u jkompli l-checkout
  2. Fil-pass tal-ħlas, il-metodi attivati ta' Cost+ jidhru bħala radio buttons
  3. Il-klijent jagħżel metodu u jikkonferma l-ordni
  4. Il-modulu joħloq ordni permezz tal-API ta' Cost+ u jirridirezzjona lejn il-paġna ta' ħlas ospitata
  5. Il-klijent jlesti l-ħlas fuq il-paġna ta' Cost+
  6. Il-klijent jirritorna lejn il-ħanut — il-ħlas jiġi vverifikat permezz tal-API
  7. 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:

  1. Il-karta tal-klijent tiġi awtorizzata (fondi riżervati) waqt il-checkout
  2. Il-capture iseħħ awtomatikament meta l-ordni tgħaddi għal Fulfilled
  3. 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:

TabellaSkop
nopayn_transactionsItraċċa ordnijiet tal-ħlas maħluqa mal-API ta' Cost+
nopayn_refundsTirreġistra operazzjonijiet ta' rifużjoni għal skopijiet ta' awditjar

Diżinstallazzjoni

drush pmu commerce_nopayn -y
drush cr

Id-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.

On this page