Cost+Docs

nopCommerce

Integrirajte Cost+ s svojo nopCommerce trgovino z uradnim plačilnim vtičnikom

nopCommerce

Integrirajte Cost+ kot plačilno metodo v svojo nopCommerce trgovino. Uradni vtičnik NoPayn Payment Gateway podpira več plačilnih metod z neposredno preusmeritvijo na izbrano plačilno metodo — v celoti skladen s PCI DSS.

Predpogoji

  • Aktiven trgovski račun Cost+
  • nopCommerce 4.90 ali novejši
  • .NET 9
  • Skrbniški dostop do vaše nopCommerce skrbniške plošče
  • Dostop do izvorne kode nopCommerce (za namestitev vtičnika)

Podprte plačilne metode

Ime na blagajniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

1. Namestite vtičnik

Kopirajte mapo vtičnika v imenik izvorne kode nopCommerce:

src/Plugins/Nop.Plugin.Payments.NoPayn/

Dodajte projekt v vašo rešitev in zgradite:

dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet build

V skrbniški plošči nopCommerce:

  1. Pojdite na Konfiguracija → Lokalni vtičniki
  2. Poiščite NoPayn Payment Gateway in kliknite Namesti
  3. Pojdite na Konfiguracija → Plačilne metode
  4. Aktivirajte NoPayn Payment Gateway
  5. Kliknite Konfiguriraj za odprtje nastavitev

2. Konfigurirajte vtičnik

Prijavite se v portal trgovca in pojdite na Spletna mesta, nato kliknite na spletno mesto, ki ga želite povezati. Kliknite na Integracija, kjer boste našli vaš API ključ.

Portal trgovca Cost+ s prikazom API ključa

V konfiguraciji vtičnika vnesite vaš API ključ in preklopite plačilne metode, ki jih želite ponuditi:

NastavitevOpis
API KeyVaš NoPayn API ključ
Enable Credit / Debit CardPreklopite plačila s kreditno/debetno kartico
Enable Apple PayPreklopite plačila Apple Pay
Enable Google PayPreklopite plačila Google Pay
Enable Vipps MobilePayPreklopite plačila Vipps MobilePay

Aktivirajte samo plačilne metode, za katere ste bili odobreni in ste prejeli potrditev.

3. Tok plačila

  1. Stranka izbere NoPayn Payment Gateway na blagajni
  2. Prikaže se izbira pod-metode (kreditna kartica, Apple Pay itd.)
  3. Stranka izbere metodo in potrdi naročilo
  4. Naročilo je ustvarjeno s statusom plačila Čakajoče
  5. Stranka je neposredno preusmerjena na izbrano plačilno metodo na plačilni strani NoPayn
  6. Po plačilu:
    • Uspeh — naročilo označeno kot Plačano / V obdelavi
    • Preklicano / Neuspešno / Poteklo — naročilo nastavljeno na Preklicano
  7. NoPayn pošlje webhook za asinhrono potrditev statusa

Transakcije potečejo po 5 minutah. Če stranka ne dokonča plačila v tem oknu, je naročilo samodejno preklicano prek webhook-a.

4. Preslikava statusov naročila

NoPayn statusnopCommerce status plačilanopCommerce status naročila
newPendingPending
processingPendingPending
completedPaidProcessing
cancelledVoidedCancelled
expiredVoidedCancelled
errorVoidedCancelled

5. Webhook-i

Vtičnik registrira končno točko webhook-a na /NoPayn/Webhook. NoPayn pošlje POST podatke z identifikatorjem naročila ob spremembah statusa. Vtičnik preveri trenutni status prek API klica pred posodobitvijo naročila.

Ročna konfiguracija webhook-a ni potrebna — vtičnik samodejno obravnava registracijo.

6. Testirajte in zaženite

Izvedite nekaj testnih transakcij, da zagotovite nemoteno delovanje. Priporočamo testiranje tako uspešnih kot neuspešnih plačil za potrditev pravilne obravnave vseh scenarijev.

Podpora

Potrebujete pomoč? Obrnite se na našo ekipo za podporo na support@costplus.io.

On this page