DocsnopCommerce
Integrujte Cost+ s vaším nopCommerce obchodem pomocí oficiálního platebního pluginu
Integrujte Cost+ jako platební metodu do vašeho nopCommerce obchodu. Oficiální plugin NoPayn Payment Gateway podporuje více platebních metod s přímým přesměrováním na zvolenou platební metodu — plně v souladu s PCI DSS.
Předpoklady
- Aktivní obchodní účet Cost+
- nopCommerce 4.90 nebo novější
- .NET 9
- Administrátorský přístup k panelu správy nopCommerce
- Přístup ke zdrojovému kódu nopCommerce (pro instalaci pluginu)
Podporované platební metody
| Zobrazovaný název v checkoutu | NoPayn identifikátor |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Nainstalujte plugin
Zkopírujte složku pluginu do zdrojového adresáře nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Přidejte projekt do řešení a sestavte:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildV panelu správy nopCommerce:
- Přejděte na Configuration → Local plugins
- Najděte NoPayn Payment Gateway a klikněte na Install
- Přejděte na Configuration → Payment methods
- Aktivujte NoPayn Payment Gateway
- Klikněte na Configure pro otevření nastavení
2. Nakonfigurujte plugin
Přihlaste se do obchodního portálu a přejděte na Weby, poté klikněte na web, který chcete propojit. Klikněte na Integrace, kde najdete svůj API klíč.
V konfiguraci pluginu zadejte svůj API Key a přepněte platební metody, které chcete nabídnout:
| Nastavení | Popis |
|---|---|
| API Key | Váš NoPayn API klíč |
| Enable Credit / Debit Card | Přepnout platby kartou |
| Enable Apple Pay | Přepnout platby Apple Pay |
| Enable Google Pay | Přepnout platby Google Pay |
| Enable Vipps MobilePay | Přepnout platby Vipps MobilePay |
Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.
3. Platební tok
- Zákazník vybere NoPayn Payment Gateway při checkoutu
- Zobrazí se výběr dílčí metody (Credit Card, Apple Pay atd.)
- Zákazník vybere metodu a potvrdí objednávku
- Objednávka je vytvořena se stavem platby Pending
- Zákazník je přesměrován přímo na zvolenou platební metodu na platební stránce NoPayn
- Po platbě:
- Úspěch — objednávka označena jako Paid / Processing
- Zrušeno / Selhání / Vypršení — objednávka nastavena na Cancelled
- NoPayn odešle webhook pro asynchronní potvrzení stavu
Transakce vyprší po 5 minutách. Pokud zákazník nedokončí platbu v tomto časovém okně, objednávka je automaticky zrušena prostřednictvím webhooku.
4. Mapování stavů objednávek
| Stav NoPayn | Stav platby nopCommerce | Stav objednávky nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooky
Plugin registruje webhook endpoint na /NoPayn/Webhook. NoPayn odesílá POST data obsahující identifikátor objednávky při změnách stavu. Plugin ověří aktuální stav prostřednictvím API volání před aktualizací objednávky.
Ruční konfigurace webhooku není nutná — plugin zajišťuje registraci automaticky.
6. Otestujte a spusťte
Proveďte několik testovacích transakcí, abyste se ujistili, že vše funguje hladce. Doporučujeme otestovat jak úspěšné, tak neúspěšné platby pro ověření, že jsou všechny scénáře správně zpracovány.
Podpora
Potřebujete pomoc? Obraťte se na náš tým podpory na support@costplus.io.