Cost+Docs

Magento

Integra Cost+ mal-ħanut Magento tiegħek (2.x u 1.9 / OpenMage LTS)

Magento

Integra Cost+ bħala metodu ta' ħlas fil-ħanut Magento tiegħek. L-estensjoni Cost+ hija disponibbli għal Magento 2 (2.4.6 – 2.4.8) u Magento 1.9 (inkluż OpenMage LTS 20+).

Prerekwiżiti

  • Kont attiv ta' kummerċjant Cost+
  • Installazzjoni ta' Magento 2.4.6 – 2.4.8
  • PHP 8.2 – 8.4
  • Aċċess ta' amministratur għall-pannell tal-amministrazzjoni ta' Magento
  • Aċċess SSH għas-server tiegħek (għall-installazzjoni b'Composer)
  • Kont attiv ta' kummerċjant Cost+
  • Magento 1.9.x jew OpenMage LTS 20+
  • PHP 7.4 jew aktar tard
  • Aċċess ta' amministratur għall-pannell tal-amministrazzjoni ta' Magento
  • Aċċess SSH jew FTP għas-server tiegħek

1. Installa l-Estensjoni

Metodu A: Installazzjoni permezz ta' Composer (Rakkomandat)

Ikkonnettja mas-server Magento tiegħek permezz ta' SSH u mur fid-direttorju root ta' Magento.

Installa l-plugin:

composer require nopayn/nopayn-magento-2

Mexxi l-kmandi ta' setup ta' Magento:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Jekk qiegħed f'modalità ta' produzzjoni, mexxi wkoll:

php bin/magento setup:static-content:deploy

Metodu B: Installazzjoni Manwali

  1. Mur fid-direttorju app/code tiegħek
  2. Niżżel u unzippja r-rilaxx ta' Cost+ minn GitHub
  3. Mexxi l-kmandi ta' setup:
php bin/magento setup:upgrade
php bin/magento cache:clean

Jekk f'modalità ta' produzzjoni:

php bin/magento setup:static-content:deploy

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

Ikkopja l-kontenut ta' app/ fid-direttorju root app/ ta' Magento tiegħek:

cp -r app/* /path/to/magento/app/

Naddaf il-cache ta' Magento:

rm -rf var/cache/*

Idħol fil-pannell tal-amministrazzjoni ta' Magento u mur fuq System → Configuration → Sales → Payment Methods biex tivverifika li s-sezzjoni NoPayn Payment Gateway tidher.

Il-modulu joħloq tabella nopayn_transactions fid-database tiegħek biex itraċċa t-tranżazzjonijiet tal-ħlas. Din tinħoloq awtomatikament fl-ewwel użu.

2. Ikkonfigura l-Plugin

  1. Mur fuq Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Daħħal iċ-ċavetta API tiegħek (ara pass 3 hawn taħt)
  3. Attiva l-metodi ta' ħlas li ġejt apprvat għalihom
  4. Issejvja l-bidliet
  1. Mur fuq System → Configuration → Sales → Payment Methods
  2. Sib is-sezzjoni NoPayn Payment Gateway
  3. Daħħal iċ-ċavetta API tiegħek (ara pass 3 hawn taħt)
  4. Attiva l-metodi individwali ta' ħlas (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Opzjonalment irrestrinġi skont il-pajjiż
  6. Issejvja l-konfigurazzjoni

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

Waħħal iċ-ċavetta API fil-qasam ta' konfigurazzjoni u ssejvja.

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

Metodi ta' Ħlas Appoġġjati

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

Flusso tal-Ħlas

  1. Il-klijent jagħżel metodu ta' ħlas fil-checkout u jqiegħed l-ordni
  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
  1. Il-klijent jagħżel metodu ta' ħlas fil-checkout u jqiegħed l-ordni
  2. L-ordni tinħoloq bl-istatus Pending Payment
  3. Il-klijent jiġi ridirezzjonat lejn il-paġna ta' ħlas sigura ta' NoPayn
  4. Wara l-ħlas:
    • Suċċess — il-klijent jirritorna, l-istatus tiġi vverifikata permezz tal-API, l-ordni tissettja għal Processing
    • Ikkanċellata — il-klijent jirritorna, l-ordni tissettja għal Canceled
    • Skaduta (timeout ta' 5 minuti) — il-webhook jintlaħaq, l-ordni tissettja għal Canceled
  5. NoPayn tibgħat webhook għal konferma asinkrona tal-istatus

Mappa tal-Istatus tal-Ordni

Status NoPaynStat tal-Ordni ta' MagentoIstatus tal-Ordni ta' Magento
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhooks

Il-modulu jirreġistra endpoint tal-webhook f'/nopayn/payment/webhook. Din l-URL tiġi awtomatikament mibgħuta lil-NoPayn meta jinħolqu ordnijiet. Il-webhook dejjem jivverifika l-istatus tal-ordni permezz tal-API ta' NoPayn qabel ma jaġġorna l-ordni ta' Magento.

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

4. Ittestja s-Setup Tiegħek

  1. Agħmel ftit tranżazzjonijiet tat-test — kemm li jirnexxu u li jfallu
  2. Ivverifika li l-metodi ta' ħlas attivati kollha jidhru fil-checkout
  3. Ikkonfigura l-imġiba tal-capture (capture awtomatiku vs. manwali) ibbażat fuq 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