DocsnopCommerce
Integreerige Cost+ oma nopCommerce poega ametliku makseplugina abil
Integreerige Cost+ makseviisina oma nopCommerce poega. Ametlik NoPayn Payment Gateway plugin toetab mitut makseviisi otse valitud makseviisile suunamisega — täielikult PCI DSS-iga ühilduv.
Eeldused
- Aktiivne Cost+ kaupmehe konto
- nopCommerce 4.90 või uuem
- .NET 9
- Administraatori juurdepääs teie nopCommerce halduspaneelile
- Juurdepääs nopCommerce lähtekoodile (plugina paigaldamiseks)
Toetatud makseviisid
| Kassa kuvanimi | NoPayn identifikaator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Paigaldage plugin
Kopeerige plugina kaust oma nopCommerce lähtekataloogi:
src/Plugins/Nop.Plugin.Payments.NoPayn/Lisage projekt oma lahendusse ja ehitage:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildnopCommerce halduspaneelis:
- Minge jaotisse Configuration → Local plugins
- Leidke NoPayn Payment Gateway ja klõpsake Install
- Minge jaotisse Configuration → Payment methods
- Aktiveerige NoPayn Payment Gateway
- Klõpsake Configure, et avada seaded
2. Seadistage plugin
Logige sisse kaupmehe portaali ja navigeerige jaotisse Veebilehed, seejärel klõpsake veebilehel, mida soovite ühendada. Klõpsake Integratsioon, kus leiate oma API võtme.
Plugina seadistuses sisestage oma API võti ja lülitage sisse makseviisid, mida soovite pakkuda:
| Seadistus | Kirjeldus |
|---|---|
| API Key | Teie NoPayn API võti |
| Enable Credit / Debit Card | Krediit-/deebetkaardimaksete lüliti |
| Enable Apple Pay | Apple Pay maksete lüliti |
| Enable Google Pay | Google Pay maksete lüliti |
| Enable Vipps MobilePay | Vipps MobilePay maksete lüliti |
Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.
3. Maksevoog
- Klient valib kassas NoPayn Payment Gateway
- Kuvatakse alameetodi valik (krediitkaart, Apple Pay jne)
- Klient valib meetodi ja kinnitab tellimuse
- Tellimus luuakse makse olekuga Pending
- Klient suunatakse otse valitud makseviisile NoPayn makselehel
- Pärast maksmist:
- Edukas — tellimus märgitakse olekuga Paid / Processing
- Tühistatud / ebaõnnestunud / aegunud — tellimus seatakse olekusse Cancelled
- NoPayn saadab veebihaagi asünkroonseks oleku kinnitamiseks
Tehingud aeguvad 5 minuti pärast. Kui klient ei vii makset selle aja jooksul lõpule, tühistatakse tellimus automaatselt veebihaagi kaudu.
4. Tellimuse oleku vastendamine
| NoPayn olek | nopCommerce makse olek | nopCommerce tellimuse olek |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Veebihaagid
Plugin registreerib veebihaagi lõpp-punkti aadressil /NoPayn/Webhook. NoPayn saadab olekumuutuste korral POST-andmeid tellimuse identifikaatoriga. Plugin kontrollib praegust olekut API kaudu enne tellimuse uuendamist.
Käsitsi veebihaagi seadistamist pole vaja — plugin käsitleb registreerimist automaatselt.
6. Testige ja käivitage
Tehke mõned testtehingud, et veenduda kõige sujuvas toimimises. Soovitame testida nii edukaid kui ebaõnnestunud makseid, et kinnitada kõigi stsenaariumide korrektset käsitlemist.
Tugi
Vajate abi? Võtke ühendust meie tugimeeskonnaga aadressil support@costplus.io.