DocsnopCommerce
Integrējiet Cost+ ar savu nopCommerce veikalu, izmantojot oficiālo maksājumu spraudni
Integrējiet Cost+ kā maksājumu metodi savā nopCommerce veikalā. Oficiālais NoPayn Payment Gateway spraudnis atbalsta vairākas maksājumu metodes ar tiešu novirzīšanu uz atlasīto maksājumu metodi — pilnībā PCI DSS sertificēts.
Priekšnosacījumi
- Aktīvs Cost+ tirgotāja konts
- nopCommerce 4.90 vai jaunāka versija
- .NET 9
- Administratora piekļuve jūsu nopCommerce administrācijas panelim
- Piekļuve nopCommerce pirmkodam (spraudņa instalācijai)
Atbalstītās maksājumu metodes
| Norēķinu attēlojuma nosaukums | NoPayn identifikators |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Instalējiet spraudni
Kopējiet spraudņa mapi savā nopCommerce pirmkoda direktorijā:
src/Plugins/Nop.Plugin.Payments.NoPayn/Pievienojiet projektu savam risinājumam un kompilējiet:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildnopCommerce administrācijas panelī:
- Dodieties uz Configuration → Local plugins
- Atrodiet NoPayn Payment Gateway un noklikšķiniet Install
- Dodieties uz Configuration → Payment methods
- Aktivizējiet NoPayn Payment Gateway
- Noklikšķiniet Configure, lai atvērtu iestatījumus
2. Konfigurējiet spraudni
Piesakieties tirgotāja portālā un dodieties uz Websites, tad noklikšķiniet uz vietnes, ko vēlaties savienot. Noklikšķiniet uz Integration, kur atradīsiet savu API atslēgu.
Spraudņa konfigurācijā ievadiet savu API Key un pārslēdziet maksājumu metodes, kuras vēlaties piedāvāt:
| Iestatījums | Apraksts |
|---|---|
| API Key | Jūsu NoPayn API atslēga |
| Enable Credit / Debit Card | Pārslēgt kredītkaršu/debetkaršu maksājumus |
| Enable Apple Pay | Pārslēgt Apple Pay maksājumus |
| Enable Google Pay | Pārslēgt Google Pay maksājumus |
| Enable Vipps MobilePay | Pārslēgt Vipps MobilePay maksājumus |
Aktivizējiet tikai tās maksājumu metodes, kurām esat saņēmis apstiprinājumu.
3. Maksājuma plūsma
- Klients norēķinos atlasa NoPayn Payment Gateway
- Parādās apakšmetodes atlase (Credit Card, Apple Pay utt.)
- Klients izvēlas metodi un apstiprina pasūtījumu
- Pasūtījums tiek izveidots ar Pending maksājuma statusu
- Klients tiek tieši novirzīts uz atlasīto maksājumu metodi NoPayn maksājuma lapā
- Pēc maksājuma:
- Veiksmīgs — pasūtījums atzīmēts kā Paid / Processing
- Atcelts / Neveiksmīgs / Beidzies termiņš — pasūtījums iestatīts uz Cancelled
- NoPayn nosūta webhook asinhronai statusa apstiprināšanai
Darījumu termiņš beidzas pēc 5 minūtēm. Ja klients nepabeidz maksājumu šajā laika logā, pasūtījums tiek automātiski atcelts caur webhook.
4. Pasūtījumu statusu atbilstība
| NoPayn statuss | nopCommerce maksājuma statuss | nopCommerce pasūtījuma statuss |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhook
Spraudnis reģistrē webhook galapunktu /NoPayn/Webhook. NoPayn nosūta POST datus ar pasūtījuma identifikatoru statusa izmaiņu gadījumā. Spraudnis verificē pašreizējo statusu caur API izsaukumu pirms pasūtījuma atjaunināšanas.
Manuāla webhook konfigurācija nav nepieciešama — spraudnis apstrādā reģistrāciju automātiski.
6. Testēšana un palaišana
Veiciet dažus testa darījumus, lai pārliecinātos, ka viss darbojas gludi. Iesakām testēt gan veiksmīgus, gan neveiksmīgus maksājumus, lai apstiprinātu visu scenāriju pareizu apstrādi.
Atbalsts
Nepieciešama palīdzība? Sazinieties ar mūsu atbalsta komandu: support@costplus.io.