Bezpłatna 15-minutowa konsultacja bezpośrednio z naszymi ekspertami.
Wtyczka NMI dla Shopware 6 to bezpieczne, niezawodne i elastyczne rozwiązanie do obsługi płatności przez bramkę płatniczą NMI. Wtyczka obsługuje różne typy transakcji, zarówno płatności kartą kredytową, jak i płatności ACH, dzięki czemu firmy mogą odpowiadać na różne preferencje klientów. Poza samym przetwarzaniem płatności wtyczka NMI umożliwia pełną autoryzację zamówień, dzięki czemu operatorzy sklepów mogą bezpiecznie weryfikować i pobierać płatności. Obsługuje także zwroty częściowe i pełne, dając sprzedawcom wygodne narzędzia do zarządzania transakcjami po zakupie.
Ponadto wtyczka pozwala klientom bezpiecznie zapisywać metody płatności, co przyspiesza i ułatwia kolejne zakupy. Zmniejsza to tarcie w procesie zakupowym i zwiększa współczynnik konwersji. Dzięki pełnej integracji z panelem administracyjnym Shopware operatorzy sklepów mogą zarządzać transakcjami, monitorować statusy płatności i prowadzić szczegółową dokumentację bez opuszczania platformy. Dla sprzedawców z Polski wtyczka jest interesująca przede wszystkim przy obsłudze klientów w USA przez NMI, ponieważ ACH to system przelewów z amerykańskich rachunków bankowych. Popularne w Polsce metody, takie jak BLIK, Przelewy24 czy PayU, wymagają osobnych integracji. Łącząc bezpieczeństwo, elastyczność i łatwość obsługi, wtyczka NMI zapewnia sprawny, wiarygodny i wydajny proces płatności zarówno dla sprzedawców, jak i klientów.
Wtyczka oferuje też rozszerzone opcje konfiguracji, w tym zarządzanie kluczami API dla środowisk produkcyjnego i sandbox, podpisywanie webhooków oraz weryfikację 3D Secure dla dodatkowego bezpieczeństwa płatności.
1. Pobranie
Git
git clone https://github.com/solution25com/nmi-payment-shopware-6-solution25.git
composer require solution25/nmi-payment
2. Instalacja wtyczki w Shopware 6
3. Aktywacja wtyczki
4. Weryfikacja instalacji
1. Dostęp do ustawień wtyczki
2. Ustawienia ogólne
Proszę skonfigurować następujące ustawienia:
Po instalacji i konfiguracji wtyczki opcje płatności NMI są dostępne w sklepie (storefront).
1. Płatności kartą kredytową
Ta funkcja pozwala klientom opłacić zamówienie kartą kredytową przez bramkę płatniczą NMI. Przed użyciem funkcji proszę upewnić się, że konfiguracja API dla transakcji produkcyjnych jest poprawna.
Jak to działa:
Kroki:
2. Płatności ACH
Płatności ACH (eCheck) pozwalają klientom płacić danymi rachunku bankowego i stanowią alternatywę dla transakcji kartą kredytową.
Jak to działa:
Transakcje ACH przekazują środki bezpośrednio z rachunku bankowego klienta.
Kroki:
Proszę wybrać „NMI ACH (eCheck)” jako metodę płatności.
Proszę kliknąć „Zapłać”.
Proszę podać wymagane dane rachunku bankowego.
Proszę wysłać płatność.
3. Autoryzacja i obciążenie dla kart kredytowych
Ta funkcja pozwala autoryzować i pobierać płatności w dwóch krokach. Płatność jest najpierw autoryzowana, a środki zostają zablokowane na rachunku klienta. Administrator może następnie zatwierdzić lub odrzucić obciążenie, co kończy albo anuluje transakcję.
Jak to działa:
Status płatności pozostaje „Autoryzowana”, dopóki nie zostanie ręcznie zatwierdzony.
Administrator może pobrać środki (obciążyć klienta) albo anulować płatność.
Kroki:
Proszę włączyć funkcję „Autoryzacja i obciążenie” w ustawieniach wtyczki.
Nowe zamówienia są wyświetlane jako „Autoryzowana”.
Proszę przejść do panelu administracyjnego → Zamówienia i zmienić status płatności na „Opłacona” lub „Anulowana”.
4. COLI (anulowanie pozycji zamówienia)
COLI pozwala administratorom anulować pojedyncze artykuły w zamówieniu bez wpływu na całą transakcję. Daje to większą elastyczność przy obsłudze zwrotów.
Jak to działa:
Klienci lub administratorzy mogą wybrać, które produkty mają zostać anulowane.
Pozostałe artykuły mogą zostać normalnie opłacone.
Kroki:
Proszę wybrać produkt(y) do anulowania.
Proszę kliknąć „Usuń”, aby usunąć artykuł(y).
Proszę zapisać zaktualizowane zamówienie.
Proszę zmienić status płatności z „Autoryzowana” na „Opłacona”.
Funkcja COLI została zaprojektowana do współpracy wyłącznie z rozwiązaniami iPaaS (Integration Platform as a Service) i podobnymi platformami.
5. Zwroty (pełne i częściowe)
Obsługuje pełne i częściowe zwroty płatności przez NMI.
Jak to działa:
Pełny zwrot oddaje całą kwotę płatności.
Zwrot częściowy oddaje tylko część kwoty.
Zastosowanie (pełny zwrot):
1. Proszę przejść do Zamówienia → sekcja pozycji.
2. Proszę wybrać produkt(y) do zwrotu.
3. Proszę kliknąć Zwróć artykuł.
4. Proszę zapisać zamówienie.
5. Proszę kliknąć Utwórz zwrot.
6. Proszę zmienić status na „W realizacji”.
Zastosowanie (zwrot częściowy):
1. Proszę przejść do Zamówienia → sekcja pozycji.
2. Proszę wybrać produkt(y) do zwrotu.
3. Proszę dostosować kwotę zwrotu (pełną lub częściową).
4. Proszę kliknąć Zwróć artykuł.
5. Proszę zapisać zamówienie.
6. Proszę kliknąć Utwórz zwrot.
7. Proszę zmienić status na „W realizacji”.
Pełny zwrot:
Zwrot częściowy:
1. Proszę przejść do zamówienia i wybrać produkt do zwrotu.
2. Proszę podać liczbę zwracanych artykułów.
3. Proszę zwrócić artykuły.
4. Proszę zapisać zamówienie.
5. Proszę utworzyć zwrot częściowy.
6. Proszę zmienić status zamówienia na „W realizacji”.
6. Mixed Card
Funkcja Mixed Card pozwala klientom kupować w jednym koszyku zarówno zwykłe produkty, jak i produkty w subskrypcji. Łączy zakupy standardowe i subskrypcje w jednej transakcji.
Jak to działa:
System rozróżnia zakupy jednorazowe i płatności subskrypcyjne.
Tej samej karty kredytowej można użyć dla obu rodzajów transakcji.
Zastosowanie:
1. Proszę dodać do koszyka zwykłe produkty i produkty w subskrypcji.
2. Proszę przejść do kasy.
3. Proszę zapłacić jedną kartą kredytową.
7. Zapisywanie karty (Save Card)
Pozwala klientom bezpiecznie zapisać dane karty na potrzeby przyszłych transakcji.
Jak to działa:
Tworzony jest identyfikator Vaulted ID, pod którym przechowywane są dane płatnicze klienta.
Przy kolejnych transakcjach klienci mogą wybrać płatność jednym kliknięciem.
Zastosowanie:
1. Proszę wybrać produkty i przejść do kasy.
2. Proszę wpisać dane płatnicze.
3. Proszę zaznaczyć pole „Zapisz moją kartę do przyszłych płatności”.
4. Zapisana karta będzie widoczna jako opcja płatności przy kolejnych zamówieniach.
Zarządzanie zapisanymi kartami:
Usuń kartę: usuwa zapisane dane karty z NMI.
Dodaj kartę: pozwala dodać nową kartę do przyszłych transakcji.
Ten dokument zawiera szczegółowe informacje o endpointach API dostępnych we wtyczce NMI dla Shopware 6. Endpointy pozwalają autoryzowanym użytkownikom inicjować transakcje i pobierać szczegóły transakcji za pomocą parametrów zapytania.
POST /api/transact.php
Inicjuje transakcję za pomocą parametrów zapytania przesyłanych żądaniem POST. To typowy endpoint bramki służący do przetwarzania płatności przez NMI.
Accept: application/json
security_key=6457Thfj624V5r7WUwc5v6a68Zsd6YEm
type=sale
ccnumber=4111111111111111
ccexp=1025
cvv=123
amount=1
response=1
responsetext=SUCCESS
authcode=123456
transactionid=10778056102
response_code=100
type=sale
cvvresponse=N
response=3
responsetext=Payment Token does not exist REFID:333061802
response_code=300
POST /api/query.php
Wysyła zapytanie do bramki NMI w celu pobrania szczegółów transakcji. Przydatne przy operacjach po transakcji, takich jak sprawdzenie statusu płatności, pobranie danych historycznych lub uzgadnianie rekordów.
Accept: application/json
Content-Type: application/json
{
"security_key": "6457Thfj624V5r7WUwc5v6a68Zsd6YEm",
"report_type": "transaction",
"transactionid": "10778056102"
}
{
"nm_response": {
"transaction": {
"transaction_id": "10778056102",
"transaction_type": "cc",
"condition": "complete",
"order_id": "1234567890",
"first_name": "John",
"last_name": "Smith",
"cc_number": "4xxxxxxxxxxx1111",
"cc_exp": "1025",
"amount": "1.00",
"response_text": "SUCCESS",
"response_code": "100"
}
}
}
{
"nm_response": {
"error_response": "Invalid security key provided. REFID:987654321"
}
}
1. Prawidłowa konfiguracja kluczy API
Proszę skonfigurować klucze API dla produkcji i sandboxa przed przetwarzaniem transakcji.
Proszę upewnić się, że klucze podpisu i klucze publiczne są poprawne, aby zapewnić bezpieczną komunikację.
2. Monitorowanie transakcji
Proszę regularnie sprawdzać w panelu administracyjnym → Zamówienia, czy płatności są poprawnie przetwarzane.
Proszę korzystać z funkcji „Authorize” i „Capture”, aby kontrolować zatwierdzanie płatności przed pobraniem środków.
3. Staranna obsługa zwrotów
Proszę sprawdzić, czy przy pełnym lub częściowym zwrocie wybrano właściwy produkt.
Po przetworzeniu zwrotu proszę zmienić status zamówienia na „W realizacji”.
4. Korzystanie z funkcji Mixed Card
Klienci mogą płacić jedną kartą kredytową za zwykłe produkty i produkty w subskrypcji.
5. Bezpieczne zapisywanie kart
Proszę włączyć „Zapisz kartę”, aby przyspieszyć przyszłe transakcje.
Proszę regularnie zarządzać zapisanymi kartami i je aktualizować.
6. Czyszczenie cache po zmianach
Po zapisaniu ustawień proszę zawsze wyczyścić cache Shopware, aby zmiany zostały zastosowane.
7. Testy w trybie sandbox
Proszę używać kluczy API sandbox, aby przetestować wszystkie metody płatności przed uruchomieniem.
8. Aktualizacje
Proszę aktualizować wtyczkę, aby zapewnić kompatybilność i bezpieczeństwo.
Brak opcji płatności kartą kredytową
Płatności ACH nie są przetwarzane
„Authorize and Capture” nie działa
Zwroty nie są przetwarzane
Zapisywanie karty nie działa
Transakcje Mixed Card nie działają
1. Jak skonfigurować klucze API?
Proszę przejść do ustawień wtyczki w panelu administracyjnym Shopware i wpisać klucze API dla produkcji i sandboxa oraz klucz podpisu i klucze publiczne do bezpiecznych transakcji.
2. Czy mogę przyjmować płatności ACH?
Tak, mogą Państwo włączyć NMI ACH (eCheck) jako metodę płatności, aby klienci mogli płacić danymi rachunku bankowego. ACH dotyczy rachunków bankowych w USA.
3. Jak działa funkcja „Authorize and Capture”?
Płatność jest najpierw autoryzowana i wstrzymana. Administratorzy mogą zatwierdzić lub odrzucić obciążenie, zanim środki zostaną pobrane.
4. Czy mogę anulować pojedyncze artykuły w zamówieniu?
Tak, dzięki funkcji COLI (Cancel Order by Line Item) mogą Państwo anulować pojedyncze pozycje bez wpływu na całe zamówienie.
5. Czy mogę zapisywać dane kart klientów?
Tak, po włączeniu funkcji „Zapisz kartę” dane płatnicze klientów są bezpiecznie zapisywane na potrzeby przyszłych transakcji.
6. Jak obsługiwać zwroty?
Pełne lub częściowe zwroty można obsłużyć w sekcji Zamówienia w panelu administracyjnym. Po przetworzeniu proszę zmienić status na „W realizacji”.
7. Czy klienci mogą kupić zwykłe produkty i produkty w subskrypcji jedną kartą?
Tak, funkcja Mixed Card pozwala klientom kupić zwykłe produkty i artykuły w subskrypcji jedną kartą kredytową.
8. Czy zapisywanie danych karty jest bezpieczne?
Tak, dane kart klientów są bezpiecznie przechowywane z użyciem Vaulted ID, zgodnie z PCI, co umożliwia przyszłe płatności jednym kliknięciem.
9. Jak rozwiązać problemy z płatnościami?
Proszę sprawdzić dane dostępowe API, upewnić się, że wtyczka jest aktywna, i sprawdzić statusy płatności w panelu administracyjnym. Jeśli ustawienia nie są zapisywane, proszę wyczyścić cache.