Cost+Docs

nopCommerce

Integrirajte Cost+ sa svojom nopCommerce trgovinom koristeći službeni dodatak za plaćanje

nopCommerce

Integrirajte Cost+ kao način plaćanja u svojoj nopCommerce trgovini. Službeni dodatak NoPayn Payment Gateway podržava više načina plaćanja s izravnim preusmjeravanjem na odabrani način plaćanja — potpuno usklađen s PCI DSS standardom.

Preduvjeti

  • Aktivan Cost+ trgovački račun
  • nopCommerce 4.90 ili noviji
  • .NET 9
  • Administratorski pristup vašoj nopCommerce administratorskoj ploči
  • Pristup izvornom kodu nopCommercea (za instalaciju dodatka)

Podržani načini plaćanja

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

1. Instalirajte dodatak

Kopirajte mapu dodatka u izvorni direktorij vašeg nopCommercea:

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

Dodajte projekt u svoje rješenje i kompajlirajte:

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

U nopCommerce administratorskoj ploči:

  1. Idite na Configuration → Local plugins
  2. Pronađite NoPayn Payment Gateway i kliknite Install
  3. Idite na Configuration → Payment methods
  4. Aktivirajte NoPayn Payment Gateway
  5. Kliknite Configure za otvaranje postavki

2. Konfigurirajte dodatak

Prijavite se u portal trgovca i idite na Websites, zatim kliknite na web stranicu koju želite povezati. Kliknite na Integration gdje ćete pronaći svoj API ključ.

Cost+ portal trgovca s prikazom API ključa

U konfiguraciji dodatka unesite svoj API ključ i prebacite načine plaćanja koje želite ponuditi:

PostavkaOpis
API KeyVaš NoPayn API ključ
Enable Credit / Debit CardUključi plaćanja kreditnim/debitnim karticama
Enable Apple PayUključi Apple Pay plaćanja
Enable Google PayUključi Google Pay plaćanja
Enable Vipps MobilePayUključi Vipps MobilePay plaćanja

Aktivirajte samo one načine plaćanja za koje ste odobreni i za koje ste primili potvrdu.

3. Tijek plaćanja

  1. Kupac odabire NoPayn Payment Gateway na blagajni
  2. Pojavljuje se odabir pod-metode (kreditna kartica, Apple Pay itd.)
  3. Kupac odabire metodu i potvrđuje narudžbu
  4. Narudžba se stvara sa statusom plaćanja Pending
  5. Kupac se preusmjerava izravno na odabrani način plaćanja na NoPayn stranici za plaćanje
  6. Nakon plaćanja:
    • Uspjeh — narudžba označena kao Paid / Processing
    • Poništeno / Neuspjelo / Isteklo — narudžba postavljena na Cancelled
  7. NoPayn šalje webhook za asinkronu potvrdu statusa

Transakcije istječu nakon 5 minuta. Ako kupac ne dovrši plaćanje unutar tog vremenskog okvira, narudžba se automatski poništava putem webhooka.

4. Mapiranje statusa narudžbe

NoPayn statusnopCommerce status plaćanjanopCommerce status narudžbe
newPendingPending
processingPendingPending
completedPaidProcessing
cancelledVoidedCancelled
expiredVoidedCancelled
errorVoidedCancelled

5. Webhookovi

Dodatak registrira webhook krajnju točku na /NoPayn/Webhook. NoPayn šalje POST podatke koji sadrže identifikator narudžbe pri promjenama statusa. Dodatak provjerava trenutni status putem API poziva prije ažuriranja narudžbe.

Ručna konfiguracija webhookova nije potrebna — dodatak automatski upravlja registracijom.

6. Testirajte i pokrenite

Napravite nekoliko testnih transakcija kako biste osigurali da sve radi glatko. Preporučujemo testiranje i uspješnih i neuspjelih plaćanja kako biste potvrdili da su svi scenariji pravilno obrađeni.

Podrška

Trebate pomoć? Obratite se našem timu za podršku na support@costplus.io.

On this page