Cost+Docs

OpenCart

Integra Cost+ mal-ħanut OpenCart tiegħek (4.x u 3.x / ocStore 3)

OpenCart

Integra Cost+ bħala metodu ta' ħlas fil-ħanut OpenCart tiegħek. L-estensjoni uffiċjali NoPayn Payment Gateway hija disponibbli għal OpenCart 4 u OpenCart 3 / ocStore 3.

Prerekwiżiti

  • Kont attiv ta' kummerċjant Cost+
  • OpenCart 4.0.0.0 jew aktar tard
  • PHP 8.0 jew aktar tard
  • Aċċess ta' amministratur għad-dashboard ta' OpenCart tiegħek
  • Kont attiv ta' kummerċjant Cost+
  • ocStore 3.0.x jew OpenCart 3.0.3.x
  • PHP 7.4 jew aktar tard
  • Aċċess ta' amministratur għad-dashboard ta' OpenCart tiegħek

Metodi ta' Ħlas Appoġġjati

  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Installa l-Estensjoni

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

  1. Niżżel l-aħħar rilaxx .ocmod.zip minn GitHub
  2. Fl-admin ta' OpenCart tiegħek, mur fuq Extensions → Installer
  3. Ittella' l-fajl .ocmod.zip
  4. Mur fuq Extensions → Extensions → Payment
  5. Sib NoPayn Payment Gateway u ikklikkja Install, imbagħad Edit

Metodu B: Ittella' Manwalment

  1. Niżżel jew ikklonja r-repożitorju
  2. Ikkopja l-kontenut tal-folder upload/ fid-direttorju root ta' OpenCart tiegħek
  3. Mur fuq Extensions → Extensions → Payment
  4. Sib NoPayn Payment Gateway u ikklikkja Install, imbagħad Edit

Arkitettura

OpenCart 3 juża setup ta' multi-estensjoni:

  • NoPayn - Global Settings — konfigurazzjoni kondiviża (ċavetta API, statuses tal-ordni, disponibbiltà tal-metodu, capture manwali, debug logging)
  • NoPayn - Card Payments — checkout bil-karta ta' kreditu/debitu
  • NoPayn - Apple Pay / Google Pay — checkout bil-wallet (jekk wallet waħda biss hija attivata, it-tikkettu jaġġusta awtomatikament)
  • NoPayn - Vipps MobilePay — checkout b'Vipps/MobilePay
  • NoPayn - Swish — checkout b'Swish

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

  1. Niżżel l-asset .ocmod.zip mill-aħħar rilaxx ta' GitHub

Uża l-asset .ocmod.zip mir-rilaxx — mhux id-downloads "Source code" iġġenerati awtomatikament minn GitHub, li fihom il-layout tar-repożitorju, mhux il-layout tal-installer.

  1. Fl-admin, mur fuq Extensions → Installer
  2. Ittella' l-fajl .ocmod.zip
  3. Mur fuq Extensions → Extensions → Payments
  4. Installa NoPayn - Global Settings l-ewwel
  5. Iftaħ NoPayn - Global Settings u kkonfigura:
    • Ċavetta API
    • Statuses tal-ordni għal kompluta, pending, u kkanċellata
    • Metodi ta' ħlas disponibbli li l-kont tal-kummerċjant tiegħek huwa apprvat għalihom
    • Opzjonali: capture manwali tal-karta
    • Opzjonali: debug logging
  6. Installa l-moduli tal-checkout li trid tesponi:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Għal kull modulu tal-checkout, issettja: Status, Geo Zone, u Sort Order

Metodu B: Ittella' Manwalment

  1. Niżżel jew ikklonja r-repożitorju
  2. Ikkopja l-kontenut tal-folder upload/ fid-direttorju root tal-ħanut tiegħek
  3. Mur fuq Extensions → Extensions → Payments
  4. Segwi l-istess ordni ta' installazzjoni bħal Metodu A (Global Settings l-ewwel, imbagħad moduli tal-checkout)

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

Fis-settings ta' NoPayn Payment Gateway, daħħal iċ-Ċavetta API tiegħek fil-qasam korrispondenti.

F'NoPayn - Global Settings, daħħal iċ-Ċavetta API tiegħek fil-qasam korrispondenti. Iċ-ċavetta API hija kondiviża bejn il-moduli kollha tal-checkout — trid iddaħħalha darba biss.

3. Ikkonfigura s-Settings tal-Ħlas

  1. Attiva l-metodi ta' ħlas li ġejt apprvat għalihom
  2. Issettja l-istatus tal-ordni ppreferut għal ħlasijiet kompluti, pending, u kkanċellati
  3. Opzjonalment irrestrinġi l-ħlasijiet skont il-Geo Zone
  4. Issettja l-Istatus għal Attivat
  5. Ikklikkja Save

Settings Globali

NoPayn - Global Settings jaħżen il-konfigurazzjoni kondiviża kollha:

SettingDeskrizzjoni
API KeyIċ-ċavetta API NoPayn tiegħek
Order StatusesMappa tal-istatus għal kompluta, pending, u kkanċellata
Method AvailabilityLiema metodi ta' ħlas il-kont tal-kummerċjant tiegħek huwa apprvat għalihom
Manual CaptureAwtorizza ħlasijiet bil-karta ta' kreditu biss — aqbad aktar tard
Debug LoggingAttiva logging dettaljat għas-soluzzjoni tal-problemi

Settings tal-Modulu tal-Checkout

Kull modulu tal-checkout għandu s-settings tal-vetrina tiegħu stess:

SettingDeskrizzjoni
StatusAttiva jew diżattiva din il-metodu ta' ħlas fil-checkout
Geo ZoneIrrestrinġi għal żoni ġeografiċi speċifiċi
Sort OrderOrdni tal-wiri fuq il-paġna tal-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 ta' NoPayn
  3. Wara l-ħlas, il-klijent jirritorna u l-istatus tal-ordni tiġi aġġornata awtomatikament
  4. NoPayn tibgħat webhook għal konferma asinkrona tal-istatus

L-estensjoni tuża l-Paġna ta' Ħlas Ospitata ta' Cost+, li tfisser li l-klijenti jiġu ridirezzjonati lejn formola ta' ħlas sigura. L-ebda data sensittiva tal-karti ma tiġi ttrattat mis-server tiegħek.

Kull modulu tal-checkout huwa estensjoni separata ta' ħlas ta' OpenCart, u jagħti lill-klijenti opzjonijiet ta' radio distinti fil-checkout (eż. "Card Payments", "Apple Pay & Google Pay").

  1. Il-klijent jagħżel tikkettu tal-metodu ta' ħlas fil-checkout (eż. Card Payments)
  2. L-estensjoni toħloq ordni ta' ħlas ospitata ta' NoPayn
  3. Il-klijent jiġi ridirezzjonat lejn il-paġna ta' ħlas sigura ta' NoPayn
  4. Wara l-ħlas, il-klijent jirritorna u l-istatus tal-ordni tiġi aġġornata awtomatikament
  5. NoPayn tibgħat webhook għal konferma asinkrona tal-istatus

Il-modulu Apple Pay / Google Pay jibgħat iż-żewġ metodi f'tranżazzjoni waħda sabiex il-paġna ospitata ta' NoPayn tista' toffri ż-żewġ opzjonijiet tal-wallet f'flusso wieħed.

Aġġornament minn v1.0.0 għal v2.0.0

Il-Verżjoni 1.0.0 kienet tuża metodu waħda ta' checkout imsejħa "NoPayn Checkout". Il-Verżjoni 2.0.0 tinbidel għal moduli separati ta' checkout għal kull metodu ta' ħlas. Meta taġġorna:

  1. Ittella' l-pakkett il-ġdid
  2. L-entry eżistenti "NoPayn Checkout" tiegħek issir NoPayn - Global Settings
  3. Irrevedi u ssejvja s-settings globali
  4. Installa u attiva l-moduli ġodda tal-checkout li trid il-klijenti jaraw

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