Cost+Docs

osCommerce

Integra Cost+ mal-ħanut osCommerce 4 tiegħek bl-użu tal-modulu uffiċjali tal-ħlas

osCommerce

Integra Cost+ bħala metodu ta' ħlas fil-ħanut osCommerce 4 tiegħek. Il-modulu uffiċjali NoPayn Payments 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+
  • osCommerce 4.x
  • PHP 8.1 jew aktar tard
  • Estensjoni cURL attivata
  • Ċertifikat SSL (HTTPS meħtieġ)
  • Aċċess ta' amministratur għall-pannell tal-amministrazzjoni ta' osCommerce tiegħek

Metodi ta' Ħlas Appoġġjati

Tikkettu tal-CheckoutIdentifikatur NoPayn
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Kull metodu tista' tiġi attivata jew diżattivata individwalment mill-pannell tal-amministrazzjoni.

1. Installa l-Modulu

Niżżel jew ikklonja l-modulu minn GitHub.

Ikkopja d-direttorju lib/ fid-direttorju root ta' osCommerce 4 tiegħek:

cp -r lib/ /path/to/oscommerce/

Dan iqiegħed il-fajls tal-modulu f':

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

Fil-pannell tal-amministrazzjoni ta' osCommerce tiegħek:

  1. Mur fuq Modules → Payment → Online
  2. Attiva l-filtri "Show inactive" u "Show not installed" jekk meħtieġ
  3. Sib NoPayn Payments u ikklikkja Install

2. Ikkonfigura l-Modulu

Idħol fil-Portal tal-Kummerċjant u mur fuq Websites, imbagħad ikklikkja fuq il-website li trid tikkonnettja. Ikklikkja fuq Integration fejn issib iċ-ċavetta API tiegħek.

Portal tal-Kummerċjant ta' Cost+ li juri ċ-ċavetta API

Daħħal iċ-Ċavetta API tiegħek u kkonfigura s-settings li ġejjin:

SettingDeskrizzjoniDefault
Enable NoPayn PaymentsSwitch master ta' attiva/diżattivaTrue
API KeyIċ-ċavetta API NoPayn tiegħek—
Enable Credit / Debit CardUri credit/debit card fil-checkoutTrue
Enable Apple PayUri Apple Pay fil-checkoutTrue
Enable Google PayUri Google Pay fil-checkoutTrue
Enable Vipps MobilePayUri Vipps MobilePay fil-checkoutTrue
Manual Capture (Credit Card)Awtorizza biss — aqbad meta l-ordni tiġi komplutaFalse
Debug LoggingIkteb talbiet/risponsi tal-API fil-logFalse
Completed Order StatusIstatus issettjat meta l-ħlas jirnexxieluProcessing
Pending Order StatusIstatus issettjat waqt li qed jistenna l-ħlasPending
Cancelled Order StatusIstatus issettjat fuq kanċellazzjoni/falliment/skadenzaCancelled
Payment ZoneIrrestrinġi għal żona ġeografika (opzjonali)Iż-żoni kollha
Sort OrderOrdni tal-wiri fuq il-paġna tal-checkout0

Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.

3. Aġġorna t-Tikketti tal-Checkout (Rakkomandat)

It-tikketti default tal-buttuna tal-checkout ta' osCommerce jassumu flusso ta' pass wieħed. Għal esperjenza aħjar bir-redirect tal-ħlas offsite, aġġorna dawn it-traduzzjonijiet f'Admin → Localisation → Languages → English → Define:

ĊavettaDefaultRakkomandat
TEXT_PAY_WITH_CARDPay with cardGo to payment
TEXT_CONFIRM_AND_PAYConfirm and payReview order
CONFIRM_ORDERConfirm orderConfirm and pay

Dan itejjeb l-esperjenza tal-klijent billi jagħmel il-flusso tal-checkout aktar ċar — il-klijenti jifhmu li se jiġu ridirezzjonati biex jlestu l-ħlas fuq paġna sigura.

4. Flusso tal-Ħlas

Ladarba kkonfigurat, il-flusso tal-ħlas jaħdem hekk:

  1. Il-klijent jagħżel metodu ta' ħlas ta' Cost+ fil-checkout
  2. Il-klijent jikkonferma l-ordni
  3. Il-modulu joħloq ordni pending u jsejjaħ l-API ta' Cost+
  4. Il-klijent jiġi ridirezzjonat lejn il-Paġna ta' Ħlas Ospitata (HPP) ta' Cost+
  5. Il-klijent jlesti l-ħlas fuq il-HPP sigura
  6. Il-klijent jiġi ridirezzjonat lura lejn il-ħanut
  7. Il-modulu jivverifika l-istatus tal-ħlas permezz tal-API ta' Cost+
  8. L-istatus tal-ordni tiġi aġġornata skont dan

Il-links tal-ħlas jiskadu wara 5 minuti. Jekk il-klijent ma jlestiex il-ħlas f'din it-tieqa ta' żmien, l-ordni tiġi awtomatikament immarka bħala kkanċellata.

5. Webhooks

Il-modulu jirreġistra URL tal-webhook ma' Cost+ għal aġġornamenti tal-istatus server-to-server. Meta l-istatus ta' ħlas tinbidel, Cost+ tibgħat notifika u l-modulu:

  1. Jirċievi l-webhook POST
  2. Jivverifika l-istatus tal-ħlas permezz tal-API (qatt ma jafda l-payload tal-webhook)
  3. Jaġġorna l-istatus tal-ordni f'osCommerce

L-ebda konfigurazzjoni manwali tal-webhook mhix meħtieġa — il-modulu jittratta r-reġistrazzjoni awtomatikament.

Capture Manwali

Meta attivat għal ħlasijiet bil-karta ta' kreditu:

  • Il-ħlas jiġi awtorizzat iżda mhux maqbud fil-checkout
  • Il-fondi jinqabdu meta l-ordni tgħaddi għall-istatus completed
  • Jekk l-ordni tiġi kkanċellata, l-awtorizzazzjoni tiġi awtomatikament annullata

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.

Debug Logging

Meta Debug Logging huwa attivat, il-modulu jikteb f'nopayn_debug.log fid-direttorju tal-logs ta' osCommerce. L-entries tal-log jinkludu:

  • It-talbiet u r-risponsi kollha tal-API
  • Avvenimenti tal-webhook u riżultati tal-ipproċessar
  • Operazzjonijiet ta' capture u void
  • Żbalji (dejjem irreġistrati, irrispettivament mit-toggle tad-debug)

L-entries kollha huma pprefissati b'NoPayn_ għal filtrazzjoni faċli.

Diżinstallazzjoni

  1. Mur fuq Modules → Payment → Online fil-pannell tal-amministrazzjoni
  2. Agħżel NoPayn Payments
  3. Ikklikkja Remove

Id-diżinstallazzjoni tal-modulu tneħħi l-konfigurazzjoni u tneħħi t-tabelli tad-database 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. Nirrakkomandaw li tittestja kemm ħlasijiet li jirnexxu u li jfallu biex tikkonferma li x-xenarji kollha huma ttrattat kif suppost.

Appoġġ

Għandek bżonn l-għajnuna? Ikkuntattja t-tim tal-appoġġ tagħna fuq support@costplus.io.

On this page