Drupal Commerce

Zintegruj Cost+ jako metodę płatności w swoim sklepie Drupal Commerce. Oficjalny moduł NoPayn Payment Gateway korzysta z hostowanej strony płatności, więc żadne dane karty nie trafiają na Twój serwer — w pełni zgodny z PCI DSS.

Wymagania wstępne

• Aktywne konto sprzedawcy Cost+
• Drupal 10 lub 11
• Drupal Commerce 3.x
• PHP 8.1 lub nowszy
• Dostęp administratora do witryny Drupal

Obsługiwane metody płatności

• Credit / Debit Card — Visa, Mastercard i inne
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Zainstaluj moduł

Skopiuj moduł commerce_nopayn do instalacji Drupal i włącz go:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Dodaj bramkę płatności

1. Przejdź do Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
2. Kliknij Add payment gateway
3. Wybierz NoPayn Payment Gateway jako wtyczkę

3. Skonfiguruj bramkę

Wprowadź następujące ustawienia:

• NoPayn API Key — Twój klucz API sprzedawcy z portalu sprzedawcy
• Payment Methods — Włącz lub wyłącz Credit Card, Apple Pay, Google Pay, Vipps MobilePay
• Mode — Ustaw na Test przy użyciu klucza API ze strony testowej lub Live przy użyciu klucza ze strony produkcyjnej

Ustawienia opcjonalne

• Manual Capture — Autoryzuj płatności kartą bez natychmiastowego przechwycenia (środki są rezerwowane, a następnie pobierane przy realizacji zamówienia)
• Debug Logging — Włącz, aby logować wszystkie żądania i odpowiedzi API do dziennika Drupal w celu rozwiązywania problemów

Kliknij Save po zakończeniu.

4. Przepływ płatności

Po skonfigurowaniu przepływ płatności działa następująco:

1. Klient dodaje produkty do koszyka i przechodzi do kasy
2. Na etapie płatności włączone metody Cost+ są wyświetlane jako przyciski radiowe
3. Klient wybiera metodę i potwierdza zamówienie
4. Moduł tworzy zamówienie przez API Cost+ i przekierowuje na hostowaną stronę płatności
5. Klient realizuje płatność na stronie Cost+
6. Klient wraca do sklepu — płatność jest weryfikowana przez API
7. Webhook z Cost+ asynchronicznie potwierdza wynik płatności

5. Konfiguracja webhooka

URL webhooka jest automatycznie generowany przez Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

Na przykład: https://your-store.com/payment/notify/nopayn

Ten URL musi być dostępny z internetu bez uwierzytelniania. Moduł zawsze weryfikuje status płatności przez API — nigdy nie ufa samej treści webhooka.

Ręczne przechwycenie

Gdy ręczne przechwycenie jest włączone dla kart kredytowych:

1. Karta klienta jest autoryzowana (środki rezerwowane) podczas kasy
2. Przechwycenie następuje automatycznie, gdy zamówienie przechodzi do statusu Fulfilled
3. Jeśli zamówienie zostanie anulowane, autoryzacja jest anulowana przez webhook

Zwroty

Zwroty mogą być przetwarzane bezpośrednio z panelu administracyjnego Commerce. Obsługiwane są zarówno pełne, jak i częściowe zwroty.

Tabele bazy danych

Moduł tworzy dwie tabele do śledzenia:

Odinstalowanie

drush pmu commerce_nopayn -y
drush cr

Przetestuj i uruchom

Złóż kilka testowych zamówień, aby upewnić się, że wszystko działa poprawnie. Ustaw Mode bramki na Test i zweryfikuj zarówno udane, jak i nieudane płatności przed przejściem na Live.

Wsparcie

Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia pod adresem support@costplus.io.