DocsnopCommerce
A Cost+ integrálása nopCommerce áruházával a hivatalos fizetési bővítmény segítségével
Integrálja a Cost+-t fizetési módként nopCommerce áruházába. A hivatalos NoPayn Payment Gateway bővítmény több fizetési módot támogat a kiválasztott fizetési módra való közvetlen átirányítással — teljes PCI DSS megfelelőséggel.
Előfeltételek
- Aktív Cost+ kereskedői fiók
- nopCommerce 4.90 vagy újabb
- .NET 9
- Adminisztrátori hozzáférés a nopCommerce adminisztrációs panelhez
- Hozzáférés a nopCommerce forráskódhoz (a bővítmény telepítéséhez)
Támogatott fizetési módok
| Pénztári megnevezés | NoPayn azonosító |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. A bővítmény telepítése
Másolja a bővítmény mappát a nopCommerce forráskönyvtárba:
src/Plugins/Nop.Plugin.Payments.NoPayn/Adja hozzá a projektet a megoldáshoz és építse meg:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildA nopCommerce adminisztrációs panelen:
- Menjen a Konfiguráció → Helyi bővítmények menüpontra
- Keresse meg a NoPayn Payment Gateway elemet és kattintson a Telepítés gombra
- Menjen a Konfiguráció → Fizetési módok menüpontra
- Aktiválja a NoPayn Payment Gateway elemet
- Kattintson a Konfigurálás gombra a beállítások megnyitásához
2. A bővítmény 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.
A bővítmény konfigurációjában adja meg az API-kulcsot és kapcsolja be a felajánlani kívánt fizetési módokat:
| Beállítás | Leírás |
|---|---|
| API Key | Az Ön NoPayn API-kulcsa |
| Enable Credit / Debit Card | Hitel-/betéti kártyás fizetés be-/kikapcsolása |
| Enable Apple Pay | Apple Pay fizetés be-/kikapcsolása |
| Enable Google Pay | Google Pay fizetés be-/kikapcsolása |
| Enable Vipps MobilePay | Vipps MobilePay fizetés be-/kikapcsolása |
Csak azokat a fizetési módokat aktiválja, amelyekre jóváhagyást kapott és megerősítést kapott.
3. Fizetési folyamat
- Az ügyfél kiválasztja a NoPayn Payment Gateway-t a pénztárnál
- Megjelenik egy almód-választás (hitelkártya, Apple Pay stb.)
- Az ügyfél kiválaszt egy módot és megerősíti a rendelést
- A rendelés Függőben fizetési állapottal jön létre
- Az ügyfelet közvetlenül a kiválasztott fizetési módra irányítjuk a NoPayn fizetési oldalon
- A fizetés után:
- Sikeres — a rendelés Fizetve / Feldolgozás alatt állapotra vált
- Törölt / Sikertelen / Lejárt — a rendelés Törölve állapotra vált
- A NoPayn webhookot küld az aszinkron állapotmegerősítéshez
A tranzakciók 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örlésre kerül a webhookon keresztül.
4. Rendelési állapot leképezés
| NoPayn állapot | nopCommerce fizetési állapot | nopCommerce rendelési állapot |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhookok
A bővítmény regisztrál egy webhook végpontot a /NoPayn/Webhook címen. A NoPayn POST adatokat küld a rendelés azonosítóval állapotváltozáskor. A bővítmény az API-híváson keresztül ellenőrzi az aktuális állapotot a rendelés frissítése előtt.
Nincs szükség manuális webhook konfigurációra — a bővítmény automatikusan kezeli a regisztrációt.
6. 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.