Cost+Docs

PrestaShop

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

PrestaShop

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)

  1. Mur fuq Modules → Module Manager fil-pannell tal-amministrazzjoni tiegħek
  2. Ikklikkja Upload a module
  3. Iġbed u itfa l-fajl ZIP jew agħżlu manwalment
  4. Stenna sakemm l-installazzjoni tlesti
  5. Fittex "NoPayn" u ikklikkja Configure

Metodu B: Ittella' Manwalment

  1. Ikkopja l-folder nopaynpayment/ fid-direttorju modules/ ta' PrestaShop tiegħek
  2. Mur fuq Modules → Module Manager
  3. Fittex "NoPayn" u ikklikkja Install
  4. Ikklikkja Configure biex tiftaħ is-settings

Niżżel il-modulu minn GitHub.

Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)

  1. Mur fuq Improve > Module Manager fil-pannell tal-amministrazzjoni tiegħek
  2. Ikklikkja Upload a module
  3. Iġbed u itfa l-fajl ZIP jew agħżlu manwalment
  4. Stenna sakemm l-installazzjoni tlesti
  5. Skrollja isfel lejn is-sezzjoni "Other" u ikklikkja Configure taħt Cost+

PrestaShop 8 Module Manager

Djalogu Upload a module

Metodu B: Ittella' Manwalment permezz ta' (S)FTP

  1. Estratti l-fajl ZIP imniżżel
  2. Bl-użu ta' klijent SFTP (eż. FileZilla, WinSCP), ittella' l-folders kollha fid-direttorju /modules/ fl-installazzjoni ta' PrestaShop tiegħek
  3. Mur fuq Improve > Modules > Module Catalog
  4. Fittex "Cost+" -- iċċekkja t-tab Uninstalled Modules jekk meħtieġ
  5. Ikklikkja Install

Niżżel il-modulu minn GitHub.

Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)

  1. Mur fuq Improve > Module Manager fil-pannell tal-amministrazzjoni tiegħek
  2. Ikklikkja Upload a module
  3. Iġbed u itfa l-fajl ZIP jew agħżlu manwalment
  4. Stenna sakemm l-installazzjoni tlesti
  5. Skrollja isfel lejn is-sezzjoni "Other" u ikklikkja Configure taħt Cost+

PrestaShop 1.7 Module Manager

Djalogu Upload a module

Metodu B: Ittella' Manwalment permezz ta' (S)FTP

  1. Estratti l-fajl ZIP imniżżel
  2. Bl-użu ta' klijent SFTP (eż. FileZilla, WinSCP), ittella' l-folders kollha fid-direttorju /modules/ fl-installazzjoni ta' PrestaShop tiegħek
  3. Mur fuq Modules > Module Manager
  4. Fittex "Cost+" -- iċċekkja t-tab Uninstalled Modules jekk meħtieġ
  5. Ikklikkja Install

Niżżel il-modulu minn GitHub.

Metodu A: Ittella' mill-Pannell tal-Amministrazzjoni (Rakkomandat)

  1. Niżżel costpluspayment.zip mill-paġna Releases ta' GitHub
  2. Mur fuq Modules and Services fil-back office ta' PrestaShop tiegħek
  3. Ikklikkja Add a new module
  4. Ittella' l-fajl ZIP
  5. Sib Cost+ Payment Gateway fil-lista ta' moduli u ikklikkja Install

Metodu B: Ittella' Manwalment permezz ta' (S)FTP

  1. Estratti l-fajl ZIP imniżżel
  2. Bl-użu ta' klijent SFTP, ittella' l-folder costpluspayment/ fil-/modules/costpluspayment/ fl-installazzjoni ta' PrestaShop tiegħek
  3. Mur fuq Modules and Services fil-back office
  4. 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.

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

Fil-konfigurazzjoni tal-modulu NoPayn, daħħal iċ-Ċavetta API tiegħek u kkonfigura s-settings li ġejjin:

SettingDeskrizzjoni
API KeyIċ-ċavetta API NoPayn tiegħek
Credit / Debit CardAttiva/diżattiva ħlasijiet bil-karti ta' kreditu
Apple PayAttiva/diżattiva Apple Pay
Google PayAttiva/diżattiva Google Pay
Vipps MobilePayAttiva/diżattiva Vipps MobilePay
Manual CaptureAwtorizza ħlasijiet bil-karta ta' kreditu biss — aqbad meta tibgħat
Debug LoggingAttiva 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.

Paġna ta' konfigurazzjoni ta' Cost+ f'PrestaShop 8

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

Paġna ta' konfigurazzjoni ta' Cost+ f'PrestaShop 1.7

Wara l-installazzjoni, ikklikkja Configure fuq il-modulu Cost+ Payment Gateway u stabbilixxi dan li ġej:

SettingDeskrizzjoni
API KeyIċ-ċavetta API Cost+ tiegħek mill-portal tal-kummerċjant
Credit / Debit CardAttiva/diżattiva ħlasijiet bil-karti ta' kreditu
Apple PayAttiva/diżattiva Apple Pay
Google PayAttiva/diżattiva Google Pay
Vipps MobilePayAttiva/diżattiva Vipps MobilePay
Manual CaptureAwtorizza ħlasijiet bil-karta ta' kreditu biss — aqbad meta tibgħat
Checkout ExpiryTimeout tal-ordnijiet pendenti f'minuti (default 5)
Debug LoggingAttiva 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

  1. Il-klijent jagħżel metodu ta' ħlas ta' Cost+ fil-checkout
  2. Il-klijent jiġi ridirezzjonat lejn il-Paġna ta' Ħlas Ospitata (HPP) ta' Cost+
  3. Wara li jlesti l-ħlas, il-klijent jiġi ridirezzjonat lura lejn il-ħanut
  4. 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/webhook

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-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/null

Uż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

  1. Iċċekkja darbtejn il-metodi ta' ħlas attivati kollha
  2. Agħmel ftit tranżazzjonijiet tat-test -- kemm li jirnexxu u li jfallu -- biex tiżgura li kollox jimxi tajjeb
  3. 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.

On this page