Cost+Docs

Magento

A Cost+ integrálása Magento áruházával (2.x és 1.9 / OpenMage LTS)

Magento

Integrálja a Cost+-t fizetési módként Magento áruházába. A Cost+ bővítmény elérhető Magento 2 (2.4.6 – 2.4.8) és Magento 1.9 (beleértve az OpenMage LTS 20+ verziót) számára.

Előfeltételek

  • Aktív Cost+ kereskedői fiók
  • Magento 2.4.6 – 2.4.8 telepítés
  • PHP 8.2 – 8.4
  • Adminisztrátori hozzáférés a Magento adminisztrációs panelhez
  • SSH hozzáférés a szerverhez (Composer telepítéshez)
  • Aktív Cost+ kereskedői fiók
  • Magento 1.9.x vagy OpenMage LTS 20+
  • PHP 7.4 vagy újabb
  • Adminisztrátori hozzáférés a Magento adminisztrációs panelhez
  • SSH vagy FTP hozzáférés a szerverhez

1. A bővítmény telepítése

A módszer: Telepítés Composerel (ajánlott)

Csatlakozzon a Magento szerverhez SSH-n keresztül és navigáljon a Magento gyökérkönyvtárba.

Telepítse a bővítményt:

composer require nopayn/nopayn-magento-2

Futtassa a Magento beállítási parancsokat:

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

Ha éles módban van, futtassa ezt is:

php bin/magento setup:static-content:deploy

B módszer: Manuális telepítés

  1. Navigáljon az app/code könyvtárba
  2. Töltse le és csomagolja ki a Cost+ kiadást a GitHubról
  3. Futtassa a beállítási parancsokat:
php bin/magento setup:upgrade
php bin/magento cache:clean

Ha éles módban van:

php bin/magento setup:static-content:deploy

Töltse le vagy klónozza a modult a GitHubról.

Másolja az app/ tartalmát a Magento gyökér app/ könyvtárába:

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

Törölje a Magento gyorsítótárat:

rm -rf var/cache/*

Jelentkezzen be a Magento adminisztrációs panelbe és navigáljon a Rendszer → Konfiguráció → Értékesítés → Fizetési módok menüpontra, hogy ellenőrizze a NoPayn Payment Gateway szekció megjelenését.

A modul automatikusan létrehozza a nopayn_transactions táblát az adatbázisban a fizetési tranzakciók nyomon követéséhez. Ez az első használatkor jön létre automatikusan.

2. A bővítmény konfigurálása

  1. Menjen az Áruházak → Konfiguráció → Értékesítés → Fizetési módok → Cost+ Payments menüpontra
  2. Adja meg az API-kulcsot (lásd az alábbi 3. lépést)
  3. Engedélyezze a jóváhagyott fizetési módokat
  4. Mentse a változtatásokat
  1. Menjen a Rendszer → Konfiguráció → Értékesítés → Fizetési módok menüpontra
  2. Keresse meg a NoPayn Payment Gateway szekciót
  3. Adja meg az API-kulcsot (lásd az alábbi 3. lépést)
  4. Engedélyezze az egyes fizetési módokat (Hitel-/Betéti kártya, Apple Pay, Google Pay, Vipps MobilePay)
  5. Opcionálisan korlátozza ország szerint
  6. Mentse a konfigurációt

3. API hitelesítő adatok megadása

Jelentkezzen be a kereskedői portálba és navigáljon a Weboldalak menüpontra, majd kattintson a csatlakoztatni kívánt weboldalra. Kattintson az Integráció fülre, ahol megtalálja az API-kulcsot.

Cost+ kereskedői portál az API-kulccsal

Illessze be az API-kulcsot a konfigurációs mezőbe és mentse el.

Csak azokat a fizetési módokat aktiválja, amelyekre jóváhagyást kapott és megerősítést kapott.

Támogatott fizetési módok

Pénztári megnevezésNoPayn azonosító
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Fizetési folyamat

  1. Az ügyfél kiválaszt egy fizetési módot a pénztárnál és leadja a rendelést
  2. Az ügyfelet átirányítjuk a NoPayn tárolt fizetési oldalra
  3. A fizetés után az ügyfél visszatér és a rendelés állapota automatikusan frissül
  4. A NoPayn webhookot küld az aszinkron állapotmegerősítéshez
  1. Az ügyfél kiválaszt egy fizetési módot a pénztárnál és leadja a rendelést
  2. A rendelés Fizetésre vár állapottal jön létre
  3. Az ügyfelet átirányítjuk a NoPayn biztonságos fizetési oldalra
  4. A fizetés után:
    • Sikeres — az ügyfél visszatér, az állapot API-n keresztül ellenőrzésre kerül, a rendelés Feldolgozás alatt állapotra vált
    • Törölve — az ügyfél visszatér, a rendelés Törölve állapotra vált
    • Lejárt (5 perces időtúllépés) — a webhook tüzel, a rendelés Törölve állapotra vált
  5. A NoPayn webhookot küld az aszinkron állapotmegerősítéshez

Rendelési állapot leképezés

NoPayn állapotMagento rendelés állapotMagento rendelés státusz
newpending_paymentFizetésre vár
processingpending_paymentFizetésre vár
completedprocessingFeldolgozás alatt
cancelledcanceledTörölve
expiredcanceledTörölve
errorcanceledTörölve

Webhookok

A modul regisztrál egy webhook végpontot a /nopayn/payment/webhook címen. Ez az URL automatikusan elküldésre kerül a NoPayn-nak rendelések létrehozásakor. A webhook mindig az API-n keresztül ellenőrzi a rendelés állapotát a Magento rendelés frissítése előtt.

Nincs szükség manuális webhook konfigurációra — a modul automatikusan kezeli a regisztrációt.

4. Beállítás tesztelése

  1. Végezzen néhány teszttranzakciót — sikereset és sikertelent egyaránt
  2. Ellenőrizze, hogy az összes engedélyezett fizetési mód megjelenik a pénztárnál
  3. Konfigurálja a rögzítési viselkedést (automatikus rögzítés vagy manuális) a teljesítési folyamata szerint

Támogatás

Segítségre van szüksége? Forduljon ügyfélszolgálatunkhoz: support@costplus.io.

On this page