Cost+Docs

nopCommerce

Integrujte Cost+ s vasim obchodom nopCommerce pomocou oficialneho platobneho pluginu

nopCommerce

Integrujte Cost+ ako platobnu metodu vo vasom obchode nopCommerce. Oficialny plugin NoPayn Payment Gateway podporuje viacero platobnych metod s priamym presmerovanim na vybranu platobnu metodu -- plne kompatibilny s PCI DSS.

Predpoklady

  • Aktivny ucet obchodnika Cost+
  • nopCommerce 4.90 alebo novsi
  • .NET 9
  • Administratorsky pristup k vasmu administratorskemu panelu nopCommerce
  • Pristup k zdrojovemu kodu nopCommerce (pre instalaciu pluginu)

Podporovane platobne metody

Nazov zobrazeny pri pokladniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

1. Instalacia pluginu

Skopiujte priecinok pluginu do adresara zdrojoveho kodu vasho nopCommerce:

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

Pridajte projekt do vasho riesenia a zostavte:

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

V administratorskom paneli nopCommerce:

  1. Prejdite na Configuration -> Local plugins
  2. Najdite NoPayn Payment Gateway a kliknite na Install
  3. Prejdite na Configuration -> Payment methods
  4. Aktivujte NoPayn Payment Gateway
  5. Kliknite na Configure na otvorenie nastaveni

2. Konfiguracia pluginu

Prihlaste sa do obchodneho portalu a prejdite na Webove stranky, potom kliknite na webovu stranku, ktoru chcete pripojit. Kliknite na Integracia, kde najdete svoj API kluc.

Obchodny portal Cost+ zobrazujuci API kluc

V konfiguracii pluginu zadajte svoj API kluc a prepnite platobne metody, ktore chcete ponukat:

NastaveniePopis
API KeyVas NoPayn API kluc
Enable Credit / Debit CardPrepnutie platieb kreditnymi/debitnymi kartami
Enable Apple PayPrepnutie platieb Apple Pay
Enable Google PayPrepnutie platieb Google Pay
Enable Vipps MobilePayPrepnutie platieb Vipps MobilePay

Aktivujte len tie platobne metody, pre ktore ste boli schvaleni a dostali potvrdenie.

3. Platobny proces

  1. Zakaznik si vyberie NoPayn Payment Gateway pri pokladni
  2. Zobrazi sa vyber podmetody (Credit Card, Apple Pay, atd.)
  3. Zakaznik si vyberie metodu a potvrdi objednavku
  4. Objednavka sa vytvori so stavom platby Pending
  5. Zakaznik je presmerovany priamo na vybranu platobnu metodu na platobnej stranke NoPayn
  6. Po platbe:
    • Uspech -- objednavka oznacena ako Paid / Processing
    • Zrusenie / Neuspech / Exspiracia -- objednavka nastavena na Cancelled
  7. NoPayn posle webhook pre asynchronne potvrdenie stavu

Transakcie vyprsia po 5 minutach. Ak zakaznik nedokonci platbu v tomto casovom okne, objednavka sa automaticky zrusi cez webhook.

4. Mapovanie stavov objednavok

Stav NoPaynStav platby nopCommerceStav objednavky nopCommerce
newPendingPending
processingPendingPending
completedPaidProcessing
cancelledVoidedCancelled
expiredVoidedCancelled
errorVoidedCancelled

5. Webhooky

Plugin registruje webhook endpoint na /NoPayn/Webhook. NoPayn posiela POST data obsahujuce identifikator objednavky pri zmene stavu. Plugin overuje aktualny stav cez volanie API pred aktualizaciou objednavky.

Ziadna manualna konfiguracia webhooku nie je potrebna -- plugin spracuvava registraciu automaticky.

6. Testovanie a spustenie

Vykonajte niekolko testovacich transakcii, aby ste sa uistili, ze vsetko funguje spravne. Odporucame testovat uspesne aj neuspesne platby na potvrdenie spravneho spracovania vsetkych scenarov.

Podpora

Potrebujete pomoc? Kontaktujte nas tym podpory na support@costplus.io.

On this page