osCommerce

A Cost+ integrálása osCommerce 4 áruházával a hivatalos fizetési modul segítségével

Integrálja a Cost+-t fizetési módként osCommerce 4 áruházába. A hivatalos NoPayn Payments modul a tárolt fizetési oldal folyamatát használja, így kártyaadatok nem érintik az Ön szerverét — teljes PCI DSS megfelelőséggel.

Előfeltételek

Aktív Cost+ kereskedői fiók
osCommerce 4.x
PHP 8.1 vagy újabb
cURL kiterjesztés engedélyezve
SSL tanúsítvány (HTTPS szükséges)
Adminisztrátori hozzáférés az osCommerce adminisztrációs panelhez

Támogatott fizetési módok

Pénztári címke	NoPayn azonosító
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

Minden mód egyenként engedélyezhető vagy letiltható az adminisztrációs panelből.

1. A modul telepítése

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

Másolja a lib/ könyvtárat az osCommerce 4 gyökérkönyvtárba:

cp -r lib/ /path/to/oscommerce/

Ez a modulfájlokat a következő helyre helyezi:

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

Az osCommerce adminisztrációs panelen:

Navigáljon a Modulok → Fizetés → Online menüpontra
Szükség esetén engedélyezze az "Inaktív mutatása" és "Nem telepített mutatása" szűrőket
Keresse meg a NoPayn Payments modult és kattintson a Telepítés gombra

2. A modul konfigurálá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

Adja meg az API-kulcsot és konfigurálja az alábbi beállításokat:

Beállítás	Leírás	Alapértelmezett
Enable NoPayn Payments	Fő engedélyezés/letiltás kapcsoló	True
API Key	Az Ön NoPayn API-kulcsa	—
Enable Credit / Debit Card	Hitel-/betéti kártya megjelenítése a pénztárnál	True
Enable Apple Pay	Apple Pay megjelenítése a pénztárnál	True
Enable Google Pay	Google Pay megjelenítése a pénztárnál	True
Enable Vipps MobilePay	Vipps MobilePay megjelenítése a pénztárnál	True
Manual Capture (Credit Card)	Csak engedélyezés — rögzítés a rendelés befejezésekor	False
Debug Logging	API-kérések/válaszok írása a naplóba	False
Completed Order Status	Sikeres fizetés utáni állapot	Processing
Pending Order Status	Fizetésre várakozás állapota	Pending
Cancelled Order Status	Törlés/hiba/lejárat állapota	Cancelled
Payment Zone	Korlátozás földrajzi zónára (opcionális)	Minden zóna
Sort Order	Megjelenítési sorrend a pénztárnál	0

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

3. Pénztári címkék frissítése (ajánlott)

Az osCommerce alapértelmezett pénztári gombfeliratai egylépéses folyamatot feltételeznek. A külső fizetési átirányítás jobb felhasználói élményéért frissítse ezeket a fordításokat az Admin → Lokalizáció → Nyelvek → Magyar → Meghatározás menüpontban:

Kulcs	Alapértelmezett	Ajánlott
`TEXT_PAY_WITH_CARD`	Pay with card	Fizetés indítása
`TEXT_CONFIRM_AND_PAY`	Confirm and pay	Rendelés áttekintése
`CONFIRM_ORDER`	Confirm order	Megerősítés és fizetés

Ez javítja a felhasználói élményt azáltal, hogy a pénztári folyamat érthetőbb lesz — az ügyfelek megértik, hogy átirányítjuk őket a fizetés befejezéséhez egy biztonságos oldalra.

4. Fizetési folyamat

A konfigurálás után a fizetési folyamat a következőképpen működik:

Az ügyfél kiválaszt egy Cost+ fizetési módot a pénztárnál
Az ügyfél megerősíti a rendelést
A modul függő rendelést hoz létre és meghívja a Cost+ API-t
Az ügyfelet átirányítjuk a Cost+ tárolt fizetési oldalra (HPP)
Az ügyfél befejezi a fizetést a biztonságos HPP-n
Az ügyfelet visszairányítjuk az áruházba
A modul az API-n keresztül ellenőrzi a fizetés állapotát
A rendelés állapota ennek megfelelően frissül

A fizetési linkek 5 perc után lejárnak. Ha az ügyfél nem fejezi be a fizetést ezen az időablakon belül, a rendelés automatikusan töröltnek lesz jelölve.

5. Webhookok

A modul webhook URL-t regisztrál a Cost+-nál a szerverről szerverre történő állapotfrissítésekhez. Amikor egy fizetés állapota megváltozik, a Cost+ értesítést küld, és a modul:

Fogadja a webhook POST-ot
Az API-n keresztül ellenőrzi a fizetés állapotát (soha nem bízik a webhook adatcsomagban)
Frissíti a rendelés állapotát az osCommerce-ben

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
Az összeg rögzítése akkor történik, amikor a rendelés befejezett állapotra vált
Ha a rendelés törlésre kerül, az engedélyezés automatikusan érvénytelenítésre kerül

Használja a manuális rögzítést, ha csak akkor szeretné terhelni az ügyfeleket, amikor a rendelésük feladásra kerül. Ez hasznos a hosszabb teljesítési idejű kereskedők számára.

Hibakeresési naplózás

Ha a Hibakeresési naplózás engedélyezve van, a modul a nopayn_debug.log fájlba ír az osCommerce naplók könyvtárában. A naplóbejegyzések tartalmazzák:

Minden API-kérést és választ
Webhook eseményeket és feldolgozási eredményeket
Rögzítési és érvénytelenítési műveleteket
Hibákat (mindig naplózva, a hibakeresési kapcsolótól függetlenül)

Minden bejegyzés NoPayn_ előtaggal rendelkezik a könnyű szűrés érdekében.

Eltávolítás

Menjen a Modulok → Fizetés → Online menüpontra az adminisztrációs panelen
Válassza a NoPayn Payments modult
Kattintson az Eltávolítás gombra

A modul eltávolítása törli a konfigurációt és a nopayn_transactions és nopayn_refunds adatbázis táblákat. Az eltávolítás előtt exportálja a szükséges adatokat.

Tesztelés és indítás

Végezzen néhány teszttranzakciót, hogy meggyőződjön minden zökkenőmentesen működik. Javasoljuk mind a sikeres, mind a sikertelen fizetések tesztelését az összes forgatókönyv helyes kezelésének megerősítéséhez.

Támogatás

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

On this page