PrestaShop
Integra Cost+ mal-ħanut PrestaShop tiegħek (9.x, 8.x, 1.7, u 1.6)

Integra Cost+ bħala metodu ta' ħlas fil-ħanut PrestaShop tiegħek. Il-modulu Cost+ huwa disponibbli għal PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7, u PrestaShop 1.6.1.x.
Prerekwiżiti
- Kont attiv ta' kummerċjant Cost+
- PrestaShop 9.1 jew aktar tard
- PHP 8.1 jew aktar tard
- SSL/HTTPS attivat
- Aċċess ta' amministratur għall-back office ta' PrestaShop tiegħek
- Kont attiv ta' kummerċjant Cost+
- Installazzjoni ta' PrestaShop 8.x
- PHP 8.0 jew aktar tard
- Aċċess ta' amministratur għall-back office ta' PrestaShop tiegħek
- MySQL 5.4 jew ogħla
- Kont attiv ta' kummerċjant Cost+
- Installazzjoni ta' PrestaShop 1.7.x
- PHP 5.4 jew aktar tard
- Aċċess ta' amministratur għall-back office ta' PrestaShop tiegħek
- MySQL 5.4 jew ogħla
- Kont attiv ta' kummerċjant Cost+
- Installazzjoni ta' PrestaShop 1.6.1.x
- PHP 5.6 jew aktar tard (bl-estensjonijiet cURL u OpenSSL)
- SSL/HTTPS attivat fuq il-ħanut
- Aċċess ta' amministratur għall-back office ta' PrestaShop tiegħek
1. Installa l-Modulu
Niżżel il-modulu minn GitHub.
Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)
- Mur fuq Modules → Module Manager fil-pannell tal-amministrazzjoni tiegħek
- Ikklikkja Upload a module
- Iġbed u itfa l-fajl ZIP jew agħżlu manwalment
- Stenna sakemm l-installazzjoni tlesti
- Fittex "NoPayn" u ikklikkja Configure
Metodu B: Ittella' Manwalment
- Ikkopja l-folder
nopaynpayment/fid-direttorjumodules/ta' PrestaShop tiegħek - Mur fuq Modules → Module Manager
- Fittex "NoPayn" u ikklikkja Install
- Ikklikkja Configure biex tiftaħ is-settings
Niżżel il-modulu minn GitHub.
Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)
- Mur fuq Improve > Module Manager fil-pannell tal-amministrazzjoni tiegħek
- Ikklikkja Upload a module
- Iġbed u itfa l-fajl ZIP jew agħżlu manwalment
- Stenna sakemm l-installazzjoni tlesti
- Skrollja isfel lejn is-sezzjoni "Other" u ikklikkja Configure taħt Cost+


Metodu B: Ittella' Manwalment permezz ta' (S)FTP
- Estratti l-fajl ZIP imniżżel
- Bl-użu ta' klijent SFTP (eż. FileZilla, WinSCP), ittella' l-folders kollha fid-direttorju
/modules/fl-installazzjoni ta' PrestaShop tiegħek - Mur fuq Improve > Modules > Module Catalog
- Fittex "Cost+" -- iċċekkja t-tab Uninstalled Modules jekk meħtieġ
- Ikklikkja Install
Niżżel il-modulu minn GitHub.
Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)
- Mur fuq Improve > Module Manager fil-pannell tal-amministrazzjoni tiegħek
- Ikklikkja Upload a module
- Iġbed u itfa l-fajl ZIP jew agħżlu manwalment
- Stenna sakemm l-installazzjoni tlesti
- Skrollja isfel lejn is-sezzjoni "Other" u ikklikkja Configure taħt Cost+


Metodu B: Ittella' Manwalment permezz ta' (S)FTP
- Estratti l-fajl ZIP imniżżel
- Bl-użu ta' klijent SFTP (eż. FileZilla, WinSCP), ittella' l-folders kollha fid-direttorju
/modules/fl-installazzjoni ta' PrestaShop tiegħek - Mur fuq Modules > Module Manager
- Fittex "Cost+" -- iċċekkja t-tab Uninstalled Modules jekk meħtieġ
- Ikklikkja Install
Niżżel il-modulu minn GitHub.
Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)
- Niżżel
costpluspayment.zipmill-paġna Releases ta' GitHub - Mur fuq Modules and Services fil-back office ta' PrestaShop tiegħek
- Ikklikkja Add a new module
- Ittella' l-fajl ZIP
- Sib Cost+ Payment Gateway fil-lista ta' moduli u ikklikkja Install
Metodu B: Ittella' Manwalment permezz ta' (S)FTP
- Estratti l-fajl ZIP imniżżel
- Bl-użu ta' klijent SFTP, ittella' l-folder
costpluspayment/fil-/modules/costpluspayment/fl-installazzjoni ta' PrestaShop tiegħek - Mur fuq Modules and Services fil-back office
- Sib Cost+ Payment Gateway u ikklikkja Install
2. Daħħal il-Kredenzjali tal-API
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.

Fil-konfigurazzjoni tal-modulu NoPayn, daħħal iċ-Ċavetta API tiegħek u kkonfigura s-settings li ġejjin:
| Setting | Deskrizzjoni |
|---|---|
| API Key | Iċ-ċavetta API NoPayn tiegħek |
| Credit / Debit Card | Attiva/diżattiva ħlasijiet bil-karti ta' kreditu |
| Apple Pay | Attiva/diżattiva Apple Pay |
| Google Pay | Attiva/diżattiva Google Pay |
| Vipps MobilePay | Attiva/diżattiva Vipps MobilePay |
| Manual Capture | Awtorizza ħlasijiet bil-karta ta' kreditu biss — aqbad meta tibgħat |
| Debug Logging | Attiva logging dettaljat f'var/logs/nopayn_debug.log |
Waħħal iċ-ċavetta fil-qasam API Key fil-paġna ta' konfigurazzjoni tal-Librerija Cost+ u ikklikkja Save.

Waħħal iċ-ċavetta fil-qasam API Key fil-paġna ta' konfigurazzjoni tal-Librerija Cost+ u ikklikkja Save.

Wara l-installazzjoni, ikklikkja Configure fuq il-modulu Cost+ Payment Gateway u stabbilixxi dan li ġej:
| Setting | Deskrizzjoni |
|---|---|
| API Key | Iċ-ċavetta API Cost+ tiegħek mill-portal tal-kummerċjant |
| Credit / Debit Card | Attiva/diżattiva ħlasijiet bil-karti ta' kreditu |
| Apple Pay | Attiva/diżattiva Apple Pay |
| Google Pay | Attiva/diżattiva Google Pay |
| Vipps MobilePay | Attiva/diżattiva Vipps MobilePay |
| Manual Capture | Awtorizza ħlasijiet bil-karta ta' kreditu biss — aqbad meta tibgħat |
| Checkout Expiry | Timeout tal-ordnijiet pendenti f'minuti (default 5) |
| Debug Logging | Attiva logging dettaljat f'log/costplus_debug.log |
Wara li ssejvja, iftaħ Payment > Restrictions u attiva l-modulu Cost+ Payment Gateway għal kull munita li taċċetta.
Għal ambjenti ta' hosting ta' PrestaShop 8.x, 1.7 u 1.6, attiva l-opzjoni cURL CA bundle waqt il-konfigurazzjoni biex tevita problemi b'ċertifikati SSL.
3. Attiva l-Metodi ta' Ħlas
Il-metodi ta' ħlas huma kkonfigurati direttament fis-settings tal-modulu (ara pass 2 hawn fuq). Aqleb kull metodu on jew off kif meħtieġ.
Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.
Wara li ssejvja ċ-ċavetta API tiegħek, ittella' kull modulu tal-metodu ta' ħlas separatament permezz ta' Upload a module.
Irritorna lejn Improve > Module Manager, ikklikkja Upload a module mill-ġdid, u ittella' kull fajl ZIP għall-metodi ta' ħlas li trid tattiva (eż. Credit Card, MobilePay, Swish).
Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.
Il-moduli tal-ħlas se jkollhom jew opzjoni Configure (jekk hemm bżonn setup addizzjonali) jew toggle Enable/Disable biss.
Wara li ssejvja ċ-ċavetta API tiegħek, ittella' kull modulu tal-metodu ta' ħlas separatament permezz ta' Upload a module.
Irritorna lejn Improve > Module Manager, ikklikkja Upload a module mill-ġdid, u ittella' kull fajl ZIP għall-metodi ta' ħlas li trid tattiva (eż. Credit Card, MobilePay, Swish).
Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.
Il-moduli tal-ħlas se jkollhom jew opzjoni Configure (jekk hemm bżonn setup addizzjonali) jew toggle Enable/Disable biss.
Il-metodi tal-ħlas jiġu attivati direttament fil-paġna ta' konfigurazzjoni tal-modulu (ara pass 2 hawn fuq). Attiva kull metodu li trid ikun disponibbli fil-checkout.
Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.
Flusso tal-Ħlas
- Il-klijent jagħżel metodu ta' ħlas ta' Cost+ fil-checkout
- Il-klijent jiġi ridirezzjonat lejn il-Paġna ta' Ħlas Ospitata (HPP) ta' Cost+
- Wara li jlesti l-ħlas, il-klijent jiġi ridirezzjonat lura lejn il-ħanut
- Webhook jikkonferma l-istatus tal-ħlas server-to-server
Webhook
L-URL tal-webhook hija awtomatikament ikkonfigurata għal kull ordni:
https://your-shop.com/module/nopaynpayment/webhookL-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-capture iseħħ meta l-ordni tiġi kkonsenjata / immarka bħala kompluta
- Jekk l-ordni tiġi kkanċellata, l-awtorizzazzjoni tiġi awtomatikament annullata
Rifużjoni Awtomatika
Jekk ordni bi ħlas maqbud tiġi kkanċellata, il-modulu awtomatikament joħroġ rifużjoni sħiħa. Ir-rifużjonijiet parzjali jistgħu jiġu pproċessati permezz ta' credit slips ta' PrestaShop.
Tikketti tal-Buttuna tal-Checkout
Għall-aħjar esperjenza tal-utent b'flussi ta' redirect offsite, ikkunsidra li taġġorna t-tikkettu tal-buttuna tal-checkout għal "Review order" minflok "Confirm and pay", peress li l-ħlas attwali jseħħ fuq il-paġna ospitata ta' Cost+. Din hija setting globali ta' PrestaShop, mhux speċifika għall-modulu.
Webhook
Il-webhook huwa awtomatikament ikkonfigurat mill-modulu. L-ebda setup manwali mhu meħtieġ.
Webhook
Il-webhook huwa awtomatikament ikkonfigurat mill-modulu. L-ebda setup manwali mhu meħtieġ.
Webhook
Il-paġna ta' konfigurazzjoni tal-modulu turi URL tal-webhook. Ikkopjah fid-dashboard Cost+ tiegħek jekk il-kont Cost+ tiegħek jeħtieġ reġistrazzjoni statika tal-webhook.
L-endpoint tal-webhook jirċievi avvenimenti ta' Cost+, imbagħad isejjaħ lil Cost+ mill-ġdid b'GET /orders/{id} qabel ma jaġġorna l-ordni PrestaShop — dan iżomm idempotenti l-immaniġġjar tal-URL ta' ritorn u tal-webhook.
Cron tal-Iskadenza
Il-paġna ta' konfigurazzjoni tal-modulu turi URL ta' cron ta' skadenza. Skedah biex jaħdem kull minuta:
* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/nullUża l-URL eżatt muri fil-back office ta' PrestaShop tiegħek — it-token jiġi ġġenerat waqt l-installazzjoni u huwa differenti għal kull ħanut. L-endpoint tal-cron ikanċella ordnijiet Cost+ pendenti antikwati wara l-Checkout Expiry konfigurat.
Capture Manwali u Rifużjonijiet
- Bil-Manual Capture attivat, il-ħlasijiet jiġu awtorizzati fil-checkout u maqbuda meta l-ordni tiġi kkonsenjata / immarkata bħala kompluta
- Jekk ordni maqbuda tiġi kkanċellata, il-modulu joħroġ awtomatikament rifużjoni sħiħa
- Ir-rifużjonijiet parzjali jiġu pproċessati permezz ta' credit slips ta' PrestaShop
4. Passi Finali u Ttestjar
- Iċċekkja darbtejn il-metodi ta' ħlas attivati kollha
- Agħmel ftit tranżazzjonijiet tat-test -- kemm li jirnexxu u li jfallu -- biex tiżgura li kollox jimxi tajjeb
- Ikkonfigura l-imġiba avvanzata bħal capture manwali vs. awtomatiku skont il-proċess ta' eżekuzzjoni tiegħek
Appoġġ
Għandek bżonn l-għajnuna? Ikkuntattja t-tim tal-appoġġ tagħna fuq support@costplus.io.