Cost+Docs

PrestaShop

A Cost+ integrálása PrestaShop áruházával (9.x, 8.x, 1.7 és 1.6)

PrestaShop

Integrálja a Cost+-t fizetési módként PrestaShop áruházába. A Cost+ modul elérhető PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 és PrestaShop 1.6.1.x verziókhoz.

Előfeltételek

  • Aktív Cost+ kereskedői fiók
  • PrestaShop 9.1 vagy újabb
  • PHP 8.1 vagy újabb
  • SSL/HTTPS engedélyezve
  • Adminisztrátori hozzáférés a PrestaShop kezelőfelületéhez
  • Aktív Cost+ kereskedői fiók
  • PrestaShop 8.x telepítés
  • PHP 8.0 vagy újabb
  • Adminisztrátori hozzáférés a PrestaShop kezelőfelületéhez
  • MySQL 5.4 vagy újabb
  • Aktív Cost+ kereskedői fiók
  • PrestaShop 1.7.x telepítés
  • PHP 5.4 vagy újabb
  • Adminisztrátori hozzáférés a PrestaShop kezelőfelületéhez
  • MySQL 5.4 vagy újabb
  • Aktív Cost+ kereskedői fiók
  • PrestaShop 1.6.1.x telepítés
  • PHP 5.6 vagy újabb (cURL és OpenSSL bővítményekkel)
  • SSL/HTTPS engedélyezve az áruházban
  • Adminisztrátori hozzáférés a PrestaShop kezelőfelületéhez

1. A modul telepítése

Töltse le a modult a GitHubról.

A módszer: Feltöltés az adminisztrációs panelen keresztül (ajánlott)

  1. Menjen a Modulok → Modulkezelő menüpontra az adminisztrációs panelen
  2. Kattintson a Modul feltöltése gombra
  3. Húzza be a ZIP fájlt vagy válassza ki manuálisan
  4. Várja meg a telepítés befejezését
  5. Keresse meg a "NoPayn" modult és kattintson a Konfigurálás gombra

B módszer: Manuális feltöltés

  1. Másolja a nopaynpayment/ mappát a PrestaShop modules/ könyvtárába
  2. Menjen a Modulok → Modulkezelő menüpontra
  3. Keresse meg a "NoPayn" modult és kattintson a Telepítés gombra
  4. Kattintson a Konfigurálás gombra a beállítások megnyitásához

Töltse le a modult a GitHubról.

A módszer: Feltöltés az adminisztrációs panelen keresztül (ajánlott)

  1. Menjen a Fejlesztés > Modulkezelő menüpontra az adminisztrációs panelen
  2. Kattintson a Modul feltöltése gombra
  3. Húzza be a ZIP fájlt vagy válassza ki manuálisan
  4. Várja meg a telepítés befejezését
  5. Görgessen le az "Egyéb" részhez és kattintson a Konfigurálás gombra a Cost+ alatt

PrestaShop 8 Modulkezelő

Modul feltöltése párbeszédablak

B módszer: Manuális feltöltés (S)FTP-n keresztül

  1. Csomagolja ki a letöltött ZIP fájlt
  2. SFTP kliens segítségével (pl. FileZilla, WinSCP) töltse fel az összes mappát a PrestaShop telepítés /modules/ könyvtárába
  3. Menjen a Fejlesztés > Modulok > Modulkatalógus menüpontra
  4. Keresse meg a "Cost+" modult -- szükség esetén ellenőrizze a Nem telepített modulok fület
  5. Kattintson a Telepítés gombra

Töltse le a modult a GitHubról.

A módszer: Feltöltés az adminisztrációs panelen keresztül (ajánlott)

  1. Menjen a Fejlesztés > Modulkezelő menüpontra az adminisztrációs panelen
  2. Kattintson a Modul feltöltése gombra
  3. Húzza be a ZIP fájlt vagy válassza ki manuálisan
  4. Várja meg a telepítés befejezését
  5. Görgessen le az "Egyéb" részhez és kattintson a Konfigurálás gombra a Cost+ alatt

PrestaShop 1.7 Modulkezelő

Modul feltöltése párbeszédablak

B módszer: Manuális feltöltés (S)FTP-n keresztül

  1. Csomagolja ki a letöltött ZIP fájlt
  2. SFTP kliens segítségével (pl. FileZilla, WinSCP) töltse fel az összes mappát a PrestaShop telepítés /modules/ könyvtárába
  3. Menjen a Modulok > Modulkezelő menüpontra
  4. Keresse meg a "Cost+" modult -- szükség esetén ellenőrizze a Nem telepített modulok fület
  5. Kattintson a Telepítés gombra

Töltse le a modult a GitHubról.

A módszer: Feltöltés az adminisztrációs panelen keresztül (ajánlott)

  1. Töltse le a costpluspayment.zip fájlt a GitHub Releases oldaláról
  2. Menjen a Modules and Services menüpontra a PrestaShop kezelőfelületén
  3. Kattintson az Add a new module gombra
  4. Töltse fel a ZIP fájlt
  5. Keresse meg a Cost+ Payment Gateway modult a modul listában és kattintson az Install gombra

B módszer: Manuális feltöltés (S)FTP-n keresztül

  1. Csomagolja ki a letöltött ZIP fájlt
  2. SFTP kliens segítségével töltse fel a costpluspayment/ mappát a /modules/costpluspayment/ helyre a PrestaShop telepítésében
  3. Menjen a Modules and Services menüpontra a kezelőfelületen
  4. Keresse meg a Cost+ Payment Gateway modult és kattintson az Install gombra

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

A NoPayn modul konfigurációjában adja meg az API-kulcsot és konfigurálja az alábbi beállításokat:

BeállításLeírás
API KeyAz Ön NoPayn API-kulcsa
Credit / Debit CardHitel-/betéti kártyás fizetés engedélyezése/letiltása
Apple PayApple Pay engedélyezése/letiltása
Google PayGoogle Pay engedélyezése/letiltása
Vipps MobilePayVipps MobilePay engedélyezése/letiltása
Manual CaptureHitelkártyás fizetések csak engedélyezése — rögzítés szállításkor
Debug LoggingRészletes naplózás engedélyezése a var/logs/nopayn_debug.log fájlba

Illessze be a kulcsot az API Key mezőbe a Cost+ Library konfigurációs oldalon és kattintson a Mentés gombra.

Cost+ konfigurációs oldal PrestaShop 8-ban

Illessze be a kulcsot az API Key mezőbe a Cost+ Library konfigurációs oldalon és kattintson a Mentés gombra.

Cost+ konfigurációs oldal PrestaShop 1.7-ben

Telepítés után kattintson a Configure gombra a Cost+ Payment Gateway modulon és állítsa be a következőket:

BeállításLeírás
API KeyAz Ön Cost+ API-kulcsa a kereskedői portálról
Credit / Debit CardHitel-/betéti kártyás fizetés engedélyezése/letiltása
Apple PayApple Pay engedélyezése/letiltása
Google PayGoogle Pay engedélyezése/letiltása
Vipps MobilePayVipps MobilePay engedélyezése/letiltása
Manual CaptureHitelkártyás fizetések engedélyezése — rögzítés szállításkor
Checkout ExpiryFüggőben lévő rendelés időtúllépése percben (alapértelmezett 5)
Debug LoggingRészletes naplózás engedélyezése a log/costplus_debug.log fájlba

Mentés után nyissa meg a Payment > Restrictions menüt és engedélyezze a Cost+ Payment Gateway modult minden elfogadott pénznem számára.

PrestaShop 8.x, 1.7 és 1.6 tárhelykörnyezetekhez engedélyezze a cURL CA bundle opciót a konfiguráció során az SSL tanúsítvány problémák elkerülése érdekében.

3. Fizetési módok engedélyezése

A fizetési módok közvetlenül a modul beállításaiban konfigurálhatók (lásd a fenti 2. lépést). Kapcsolja be vagy ki az egyes módokat szükség szerint.

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

Az API-kulcs mentése után töltse fel az egyes fizetési mód modulokat külön a Modul feltöltése gombbal.

Térjen vissza a Fejlesztés > Modulkezelő menüpontra, kattintson a Modul feltöltése gombra ismét, és töltse fel az egyes ZIP fájlokat az engedélyezni kívánt fizetési módokhoz (pl. hitelkártya, MobilePay, Swish).

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

A fizetési modulok vagy Konfigurálás opcióval rendelkeznek (ha további beállítás szükséges), vagy csak Engedélyezés/Letiltás kapcsolóval.

Az API-kulcs mentése után töltse fel az egyes fizetési mód modulokat külön a Modul feltöltése gombbal.

Térjen vissza a Fejlesztés > Modulkezelő menüpontra, kattintson a Modul feltöltése gombra ismét, és töltse fel az egyes ZIP fájlokat az engedélyezni kívánt fizetési módokhoz (pl. hitelkártya, MobilePay, Swish).

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

A fizetési modulok vagy Konfigurálás opcióval rendelkeznek (ha további beállítás szükséges), vagy csak Engedélyezés/Letiltás kapcsolóval.

A fizetési módokat közvetlenül a modul konfigurációs oldalán lehet ki-be kapcsolni (lásd a fenti 2. lépést). Engedélyezzen minden olyan módot, amelyet a pénztárnál elérhetővé szeretne tenni.

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

Fizetési folyamat

  1. Az ügyfél kiválaszt egy Cost+ fizetési módot a pénztárnál
  2. Az ügyfelet átirányítjuk a Cost+ tárolt fizetési oldalra (HPP)
  3. A fizetés befejezése után az ügyfelet visszairányítjuk az áruházba
  4. Egy webhook szerverről szerverre megerősíti a fizetés állapotát

Webhook

A webhook URL automatikusan konfigurálódik rendelésenként:

https://your-shop.com/module/nopaynpayment/webhook

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

Manuális rögzítés

Ha engedélyezve van a hitelkártyás fizetéseknél:

  • A fizetés engedélyezésre kerül, de nem rögzítődik a pénztárnál
  • A rögzítés akkor történik, amikor a rendelés feladásra / befejezettnek jelölésre kerül
  • Ha a rendelés törlésre kerül, az engedélyezés automatikusan érvénytelenítésre kerül

Automatikus visszatérítés

Ha egy rögzített fizetésű rendelés törlésre kerül, a modul automatikusan teljes visszatérítést kezdeményez. Részleges visszatérítések a PrestaShop jóváírási bizonylatakon keresztül dolgozhatók fel.

Pénztár gomb feliratok

A legjobb felhasználói élményért a külső átirányítási folyamatoknál fontolja meg a pénztár gomb feliratának frissítését "Rendelés áttekintése" szövegre a "Megerősítés és fizetés" helyett, mivel a tényleges fizetés a Cost+ tárolt oldalán történik. Ez egy globális PrestaShop beállítás, nem modulspecifikus.

Webhook

A webhookot a modul automatikusan konfigurálja. Nincs szükség manuális beállításra.

Webhook

A webhookot a modul automatikusan konfigurálja. Nincs szükség manuális beállításra.

Webhook

A modul konfigurációs oldala megjeleníti a webhook URL-t. Másolja át a Cost+ irányítópultjába, ha a Cost+ fiókja statikus webhook regisztrációt igényel.

A webhook végpont fogadja a Cost+ eseményeket, majd újra meghívja a Cost+-t a GET /orders/{id} kéréssel a PrestaShop rendelés frissítése előtt — ez teszi a visszatérési URL és a webhook kezelését idempotensssé.

Lejárati cron

A modul konfigurációs oldala megjeleníti a lejárati cron URL-t. Ütemezze be percenkénti futásra:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Használja a PrestaShop kezelőfelületén megjelenített pontos URL-t — a token a telepítés során generálódik, és minden bolt esetében különböző. A cron végpont törli az elavult, függőben lévő Cost+ rendeléseket a beállított Checkout Expiry után.

Manuális rögzítés és visszatérítések

  • Manual Capture engedélyezésekor a fizetések a pénztárnál engedélyezésre kerülnek és akkor rögzítődnek, amikor a rendelés feladásra / befejezettnek jelölésre kerül
  • Ha egy rögzített rendelés törlésre kerül, a modul automatikusan teljes visszatérítést kezdeményez
  • Részleges visszatérítések a PrestaShop jóváírási bizonylatakon keresztül dolgozhatók fel

4. Végső lépések és tesztelés

  1. Ellenőrizze az összes engedélyezett fizetési módot
  2. Végezzen néhány teszttranzakciót -- sikereset és sikertelent egyaránt -- az összes forgatókönyv zökkenőmentes működésének ellenőrzéséhez
  3. Konfigurálja a speciális viselkedést, például a manuális vagy automatikus rögzítést 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