DocsnopCommerce
Integracja Cost+ ze sklepem nopCommerce za pomocą oficjalnej wtyczki płatności
Zintegruj Cost+ jako metodę płatności w swoim sklepie nopCommerce. Oficjalna wtyczka NoPayn Payment Gateway obsługuje wiele metod płatności z bezpośrednim przekierowaniem do wybranej metody — w pełni zgodna z PCI DSS.
Wymagania wstępne
- Aktywne konto sprzedawcy Cost+
- nopCommerce 4.90 lub nowszy
- .NET 9
- Dostęp administratora do panelu nopCommerce
- Dostęp do kodu źródłowego nopCommerce (do instalacji wtyczki)
Obsługiwane metody płatności
| Nazwa wyświetlana w kasie | Identyfikator NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Zainstaluj wtyczkę
Skopiuj folder wtyczki do katalogu źródłowego nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Dodaj projekt do rozwiązania i zbuduj:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildW panelu administracyjnym nopCommerce:
- Przejdź do Configuration → Local plugins
- Znajdź NoPayn Payment Gateway i kliknij Install
- Przejdź do Configuration → Payment methods
- Aktywuj NoPayn Payment Gateway
- Kliknij Configure, aby otworzyć ustawienia
2. Skonfiguruj wtyczkę
Zaloguj się do portalu sprzedawcy i przejdź do sekcji Strony, następnie kliknij na stronę, którą chcesz połączyć. Kliknij Integracja, aby znaleźć swój klucz API.
W konfiguracji wtyczki wprowadź klucz API i przełącz metody płatności, które chcesz oferować:
| Ustawienie | Opis |
|---|---|
| API Key | Twój klucz API NoPayn |
| Enable Credit / Debit Card | Przełącz płatności kartą kredytową/debetową |
| Enable Apple Pay | Przełącz płatności Apple Pay |
| Enable Google Pay | Przełącz płatności Google Pay |
| Enable Vipps MobilePay | Przełącz płatności Vipps MobilePay |
Aktywuj tylko te metody płatności, na które uzyskałeś zgodę i potwierdzenie.
3. Przepływ płatności
- Klient wybiera NoPayn Payment Gateway w kasie
- Pojawia się wybór pod-metody (Credit Card, Apple Pay itp.)
- Klient wybiera metodę i potwierdza zamówienie
- Zamówienie jest tworzone ze statusem płatności Pending
- Klient jest przekierowywany bezpośrednio do wybranej metody płatności na stronie NoPayn
- Po płatności:
- Sukces — zamówienie oznaczone jako Paid / Processing
- Anulowane / Nieudane / Wygasłe — zamówienie ustawione na Cancelled
- NoPayn wysyła webhook do asynchronicznego potwierdzenia statusu
Transakcje wygasają po 5 minutach. Jeśli klient nie dokończy płatności w tym oknie, zamówienie jest automatycznie anulowane przez webhook.
4. Mapowanie statusów zamówień
| Status NoPayn | Status płatności nopCommerce | Status zamówienia nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooki
Wtyczka rejestruje punkt końcowy webhooka pod adresem /NoPayn/Webhook. NoPayn wysyła dane POST zawierające identyfikator zamówienia przy zmianach statusu. Wtyczka weryfikuje aktualny status przez wywołanie API przed aktualizacją zamówienia.
Ręczna konfiguracja webhooka nie jest wymagana — wtyczka obsługuje rejestrację automatycznie.
6. Przetestuj i uruchom
Złóż kilka testowych zamówień, aby upewnić się, że wszystko działa poprawnie. Zalecamy testowanie zarówno udanych, jak i nieudanych płatności, aby potwierdzić prawidłową obsługę wszystkich scenariuszy.
Wsparcie
Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia pod adresem support@costplus.io.