Spis treści 7 sekcji
Odbiornik webhooków płatniczych Adyen w środowisku live to adres aplikacji, pod który trafiają powiadomienia z systemu produkcyjnego. Webhook Adyen może przekazywać aktualizacje statusu płatności do Solvimon.1
Ten poradnik pokazuje, jak ustawić adres odbiornika, sprawdzić podpis i znaleźć przyczynę błędu dostarczania. Aplikacja musi potwierdzić odbiór odpowiedzią HTTP w ciągu 10 sekund.2
Dobierz bramkę
Zestawienie „Ranking bramek płatniczych dla sklepów internetowych” zbiera ceny i warunki dostawców w jednym miejscu — porównaj oferty i wybierz samodzielnie.
Zobacz rankingCzym jest odbiornik webhooków płatniczych Adyen w środowisku live?
W integracji produkcyjnej Adyen wysyła do odbiornika powiadomienia HTTP o zdarzeniach płatniczych. Odbiornik działa niezależnie od strony, na którą klient wraca po próbie zapłaty.
Przyjęcie powiadomienia potwierdza poprawną odpowiedzią HTTP, na przykład kodem 200 lub 202.2
Webhook przekazuje informację do systemu sprzedawcy bez czekania na klienta w przeglądarce. Odbiornik odczytuje typ zdarzenia, identyfikator transakcji i jej status, po czym przypisuje powiadomienie do zamówienia.
Otrzymanie powiadomienia nie oznacza jeszcze, że płatność się powiodła. O dalszej obsłudze zamówienia rozstrzyga treść zweryfikowanego zdarzenia: przy AUTHORISATION pole success ma wartość true po udanej autoryzacji, a false po nieudanej próbie.3
Odbiornik live aktualizuje stan zamówień na podstawie powiadomień z produkcyjnego środowiska Adyen, nie zaś powrotu klienta do sklepu. Odbiór webhooków ustawia się dla dwóch środowisk: testowego i produkcyjnego live.
Konfiguracji testowej nie można skopiować do live.4

Jak włączyć Adyen Auto Rescue?
Adyen Auto Rescue uruchamia się osobno od odbiornika webhooków. Sprzedawca ustala z Adyen aktywację tej usługi dla płatności direct debit, czyli obciążeń rachunku bankowego.
Dodanie adresu odbiornika samo w sobie nie włącza ponawiania nieudanych płatności.
Uruchomienie Adyen Auto Rescue wymaga następujących działań po stronie sprzedawcy:
- 1Konto sprzedawcy w Adyen trzeba wskazać przy…
- 2Płatności direct debit trzeba wskazać jako objęte…
- 3Obsługa ponawianych płatności wymaga uwzględnienia w systemie…
- Konto sprzedawcy w Adyen trzeba wskazać przy zgłaszaniu potrzeby uruchomienia Auto Rescue. Dzięki temu usługa zostanie przypisana do właściwej integracji.
- Płatności direct debit trzeba wskazać jako objęte Auto Rescue. Konfiguracja ponawiania obciążeń pozostaje wtedy oddzielona od obsługi innych metod płatności.
- Obsługa ponawianych płatności wymaga uwzględnienia w systemie zamówień. Sama próba ponowienia nie oznacza skutecznego rozliczenia transakcji.
Auto Rescue ponawia płatności direct debit; odbiornik webhooków przyjmuje powiadomienia o zdarzeniach płatniczych.
Jak sprawdzić, czy odbiornik live otrzymuje webhooki Adyen, i znaleźć przyczynę błędów?
Działanie odbiornika live sprawdzisz, zestawiając zapisane żądanie z odpowiedzią serwera. Według dokumentacji Adyen kod HTTP 200 oznacza powodzenie żądania.5
Sam kod nie mówi jednak, czy aplikacja przypisała powiadomienie do właściwej transakcji.2
Lista kontrolna pomaga odróżnić błąd dostarczenia webhooka od błędu jego obsługi. Jeśli Adyen nie dostanie poprawnej odpowiedzi HTTP w ciągu 10 sekund, uzna dostarczenie za nieudane.2
- Żądanie do odbiornika Adyen znajdź w logach serwera i porównaj z wpisem dotyczącym tej samej transakcji. Gdy żądanie dotarło, prześledź jego obsługę w aplikacji.
- Odpowiedź odbiornika Adyen odczytaj w logach tego żądania. Odbiorca musi odpowiedzieć kodem statusu HTTP po otrzymaniu webhooka.5
- Parametr notificationResponse sprawdź w odpowiedzi odbiornika. Wartość [accepted] potwierdza otrzymanie powiadomienia od Adyen.5
- Błąd obsługi transakcji ustal z logu aplikacji, jeśli żądanie dotarło, lecz status zamówienia się nie zmienił. Sprawdź rozpoznanie zdarzenia i przypisanie go do płatności.
Log żądania pokazuje, czy webhook dotarł. Odpowiedź serwera i log aplikacji pozwalają ustalić, gdzie zatrzymała się jego obsługa.
Kod HTTP 200 potwierdza przyjęcie webhooka, a 500 wskazuje błąd serwera; brak poprawnej odpowiedzi powoduje ponawianie wysyłki.6
Jak zweryfikować podpis webhooka Adyen i autentyczność powiadomienia?
Przed zmianą statusu płatności zweryfikuj podpis webhooka Adyen. Pozwala on sprawdzić, czy treść powiadomienia odpowiada danym uwierzytelniającym przypisanym do integracji.
Podpis oblicza się metodą HMAC z funkcją SHA-256, która daje wynik o długości 256 bitów.7
Weryfikacja podpisu webhooka Adyen obejmuje poniższe czynności. Przed zakodowaniem w Base64 wynik HMAC-SHA256 ma 32 bajty.8
- Typ webhooka Adyen ustal z konfiguracji integracji. Od typu powiadomienia zależy zakres podpisanych danych oraz miejsce, z którego odbiornik odczyta podpis.
- Klucz do weryfikacji pobierz z bezpiecznej konfiguracji właściwego środowiska. Nie zapisuj go w kodzie aplikacji ani w logach żądań.
- Treść powiadomienia przekaż do weryfikacji w postaci wymaganej dla danego typu webhooka. Przed obliczeniem podpisu nie zmieniaj kolejności ani wartości podpisanych danych.
- Podpis otrzymany od Adyen porównaj z podpisem obliczonym przez odbiornik. Powiadomienie odrzuć i nie zmieniaj na jego podstawie zamówienia, gdy podpisy się różnią.
Poprawny podpis pozwala odbiornikowi uznać powiadomienie za autentyczne. Dopiero wtedy aplikacja interpretuje zdarzenie płatnicze.7
Jak skonfigurować adres odbiornika webhooków Adyen w środowisku live?
Adres odbiornika webhooków Adyen w środowisku live skonfiguruj po poprawnym połączeniu integracji Adyen z Solvimon.1
Wskaż produkcyjny odbiornik powiadomień, nie adres środowiska testowego.
Poniższa lista obejmuje czynności potrzebne do kierowania aktualizacji płatności do właściwego odbiornika. Produkcyjny adres musi obsługiwać HTTPS z protokołem co najmniej TLS 1.2.4
- Adres odbiornika HTTPS przygotuj w aplikacji obsługującej płatności. Powinien prowadzić do endpointu przyjmującego powiadomienia Adyen.
- Konfigurację webhooka przypisz w Adyen Customer Area do właściwego konta sprzedawcy i wpisz adres produkcyjny. Nie używaj adresu, który służył do testów.
- Uprawnienie do odczytu konfiguracji przypisz poświadczeniom API używanym przez integrację Solvimon. Rola Management API – Webhooks read pozwala przeglądać istniejące konfiguracje webhooków Adyen, lecz nie pozwala ich edytować.1
- Opcję Skip sending to PAL uwzględnij przy webhooku przekazującym dane do Solvimon. Adyen ustawia ją osobno dla każdego webhooka, aby jego dane zawierały dodatkowe właściwości przesłane przez Solvimon podczas płatności.1
Adres produkcyjny kieruje powiadomienia do aplikacji. Zakres kont dostępnych Solvimon zależy od zakresu dostępu przyznanego poświadczeniom API. Uprawnienie „Webhooks read” pozwala jedynie wyświetlać konfiguracje webhooków; webhook określa konta i zdarzenia, dla których wysyłane są powiadomienia1.
Najczęściej zadawane pytania
Czy aktualizacja płatności przez webhook zależy od powrotu klienta do sklepu?
Nie. Adyen wysyła powiadomienie bezpośrednio do odbiornika, niezależnie od tego, czy klient wróci na stronę sklepu.
Czy odpowiedź HTTP 200 oznacza, że płatność się powiodła?
Nie — potwierdza powodzenie żądania, ale nie wynik płatności. Przy zdarzeniu AUTHORISATION o udanej autoryzacji informuje pole success ustawione na true.
Czy uprawnienie Management API – Webhooks read pozwala edytować konfigurację webhooka?
Nie. Pozwala jedynie przeglądać istniejące konfiguracje webhooków Adyen.
Co zmienia opcja Skip sending to PAL w webhooku?
Adyen ustawia ją osobno dla każdego webhooka, aby jego dane zawierały dodatkowe właściwości przekazane przez Solvimon podczas płatności.
Od czego zależy zakres kont Solvimon dostępnych dla integracji?
Od zakresu dostępu przyznanego poświadczeniom API używanym przez integrację.
Źródła
- ↑Adyen | Solvimon | Documentation https://docs.solvimon.com/integrations/paymentserviceproviders/adyen
- ↑Adyen Docs, „Handle webhook events”. ([docs.adyen.com](docs.adyen.com https://docs.adyen.com/development-resources/webhooks/handle-webhook-events
- ↑Adyen API Explorer — Result of authorisation request https://docs.adyen.com/api-explorer/Webhooks/1/post/AUTHORISATION
- ↑Adyen Docs — Configure and manage webhooks https://docs.adyen.com/development-resources/webhooks/configure-and-manage
- ↑Webhooks v3 – Automated direct debit initiated | Adyen API Explorer https://docs.adyen.com/api-explorer/Notification/3/post/DIRECT_DEBIT_INITIATED
- ↑Adyen Docs — Troubleshoot webhooks https://docs.adyen.com/development-resources/webhooks/troubleshoot/
- ↑Adyen Docs, „Verify HMAC signatures”. ([docs.adyen.com](docs.adyen.com https://docs.adyen.com/development-resources/webhooks/secure-webhooks/verify-hmac-signatures
- ↑IETF — RFC 6668 https://datatracker.ietf.org/doc/html/rfc6668