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

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-2Mexxi l-kmandi ta' setup ta' Magento:
php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:cleanJekk qiegħed f'modalità ta' produzzjoni, mexxi wkoll:
php bin/magento setup:static-content:deployMetodu B: Installazzjoni Manwali
- Mur fid-direttorju
app/codetiegħek - Niżżel u unzippja r-rilaxx ta' Cost+ minn GitHub
- Mexxi l-kmandi ta' setup:
php bin/magento setup:upgrade
php bin/magento cache:cleanJekk f'modalità ta' produzzjoni:
php bin/magento setup:static-content:deployNiżż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
- Mur fuq Stores → Configuration → Sales → Payment Methods → Cost+ Payments
- Daħħal iċ-ċavetta API tiegħek (ara pass 3 hawn taħt)
- Attiva l-metodi ta' ħlas li ġejt apprvat għalihom
- Issejvja l-bidliet
- Mur fuq System → Configuration → Sales → Payment Methods
- Sib is-sezzjoni NoPayn Payment Gateway
- Daħħal iċ-ċavetta API tiegħek (ara pass 3 hawn taħt)
- Attiva l-metodi individwali ta' ħlas (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
- Opzjonalment irrestrinġi skont il-pajjiż
- 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.

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-Checkout | Identifikatur NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Flusso tal-Ħlas
- Il-klijent jagħżel metodu ta' ħlas fil-checkout u jqiegħed l-ordni
- Il-klijent jiġi ridirezzjonat lejn il-Paġna ta' Ħlas Ospitata ta' NoPayn
- Wara l-ħlas, il-klijent jirritorna u l-istatus tal-ordni tiġi aġġornata awtomatikament
- NoPayn tibgħat webhook għal konferma asinkrona tal-istatus
- Il-klijent jagħżel metodu ta' ħlas fil-checkout u jqiegħed l-ordni
- L-ordni tinħoloq bl-istatus Pending Payment
- Il-klijent jiġi ridirezzjonat lejn il-paġna ta' ħlas sigura ta' NoPayn
- 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
- NoPayn tibgħat webhook għal konferma asinkrona tal-istatus
Mappa tal-Istatus tal-Ordni
| Status NoPayn | Stat tal-Ordni ta' Magento | Istatus tal-Ordni ta' Magento |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
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
- Agħmel ftit tranżazzjonijiet tat-test — kemm li jirnexxu u li jfallu
- Ivverifika li l-metodi ta' ħlas attivati kollha jidhru fil-checkout
- 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.