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

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-Checkout | Identifikatur NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-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.phpFil-pannell tal-amministrazzjoni ta' osCommerce tiegħek:
- Mur fuq Modules → Payment → Online
- Attiva l-filtri "Show inactive" u "Show not installed" jekk meħtieġ
- 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.

Daħħal iċ-Ċavetta API tiegħek u kkonfigura s-settings li ġejjin:
| Setting | Deskrizzjoni | Default |
|---|---|---|
| Enable NoPayn Payments | Switch master ta' attiva/diżattiva | True |
| API Key | Iċ-ċavetta API NoPayn tiegħek | — |
| Enable Credit / Debit Card | Uri credit/debit card fil-checkout | True |
| Enable Apple Pay | Uri Apple Pay fil-checkout | True |
| Enable Google Pay | Uri Google Pay fil-checkout | True |
| Enable Vipps MobilePay | Uri Vipps MobilePay fil-checkout | True |
| Manual Capture (Credit Card) | Awtorizza biss — aqbad meta l-ordni tiġi kompluta | False |
| Debug Logging | Ikteb talbiet/risponsi tal-API fil-log | False |
| Completed Order Status | Istatus issettjat meta l-ħlas jirnexxielu | Processing |
| Pending Order Status | Istatus issettjat waqt li qed jistenna l-ħlas | Pending |
| Cancelled Order Status | Istatus issettjat fuq kanċellazzjoni/falliment/skadenza | Cancelled |
| Payment Zone | Irrestrinġi għal żona ġeografika (opzjonali) | Iż-żoni kollha |
| Sort Order | Ordni tal-wiri fuq il-paġna tal-checkout | 0 |
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:
| Ċavetta | Default | Rakkomandat |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Go to payment |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Review order |
CONFIRM_ORDER | Confirm order | Confirm 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:
- Il-klijent jagħżel metodu ta' ħlas ta' Cost+ fil-checkout
- Il-klijent jikkonferma l-ordni
- Il-modulu joħloq ordni pending u jsejjaħ l-API ta' Cost+
- Il-klijent jiġi ridirezzjonat lejn il-Paġna ta' Ħlas Ospitata (HPP) ta' Cost+
- Il-klijent jlesti l-ħlas fuq il-HPP sigura
- Il-klijent jiġi ridirezzjonat lura lejn il-ħanut
- Il-modulu jivverifika l-istatus tal-ħlas permezz tal-API ta' Cost+
- 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:
- Jirċievi l-webhook POST
- Jivverifika l-istatus tal-ħlas permezz tal-API (qatt ma jafda l-payload tal-webhook)
- 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
- Mur fuq Modules → Payment → Online fil-pannell tal-amministrazzjoni
- Agħżel NoPayn Payments
- 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.