W ramach działań Mollie mających na celu poprawę niezawodności i bezpieczeństwa naszych systemów, pracujemy nad ujednoliceniem naszych identyfikatorów zasobów API zgodnie z nowym standardem – identyfikatory płatności i zamówień są następne w kolejce.
Co się zmienia?
Historycznie nasze identyfikatory API składały się z 10 znaków lub mniej (bez prefiksu, np. tr_XYZXYZXYZX). Od początku roku aktualizujemy te starsze identyfikatory do dłuższego formatu, dodając dodatkowe 4 do 12 znaków.
Nowsze zasoby – takie jak przechwycenia i linki płatności – zostały wprowadzone z wykorzystaniem tego rozszerzonego formatu od samego początku. Zwroty, starszy zasób, zostały niedawno zaktualizowane, aby przyjąć nowy format.
Następnie ta zmiana będzie miała zastosowanie do naszych najważniejszych zasobów: Płatności (Utwórz płatność -> Odpowiedź -> ID) i Zamówienia (Utwórz zamówienie -> Odpowiedź -> ID).
Co to oznacza dla Ciebie?
Jeśli korzystasz z jednej z naszych gotowych integracji, takich jak WooCommerce, Shopify lub Magento 2, nie powinieneś zauważyć żadnego wpływu z tej zmiany. Przejrzeliśmy te integracje i nie zidentyfikowaliśmy żadnych problemów z kompatybilnością.
Jednakże, jeśli masz niestandardową integrację z Mollie i/lub dodatkowe integracje downstream obsługujące te odniesienia płatności (na przykład ERP, zarządzanie zamówieniami lub systemy księgowe), proszę poświęć chwilę, aby zapoznać się z następującymi informacjami:
- Przechowywanie w bazie danych: Jeśli przechowujesz te identyfikatory, upewnij się, że długość pola nie jest ograniczona do zaledwie 10 znaków. Zalecamy długość pola wynoszącą co najmniej 40 znaków lub więcej, aby dostosować się do przyszłych potrzeb.
- Własna walidacja: Upewnij się, że wszelkie niestandardowe walidacje identyfikatorów, które posiadasz, mogą pomieścić dłuższy format. Zalecamy, aby jeśli zdecydujesz się walidować format tokena, sprawdzać jedynie, czy prefiks odpowiada Twoim oczekiwaniom i unikać walidacji pozostałej części tokena.
Ta aktualizacja nie powinna zakłócić przetwarzania płatności, ale niewłaściwe obsługiwanie nowych identyfikatorów może prowadzić do niezgodności. Dalsze informacje na temat nowego standardu można znaleźć tutaj.
Przygotuj się do testowej transakcji:
Przeprowadzimy pojedynczą transakcję testową na każdym unikalnym profilu/agentie_użytkownika/klient_id przy użyciu nowych identyfikatorów API w dniu 5 czerwca, zaczynając o 2:00 CET. Dlatego pierwsza transakcja jest kierowana na wykorzystanie nowego formatu tokena. Wszystkie kolejne transakcje ponownie wykorzystają stary standard, aż rozpoczniemy wdrożenie 12 czerwca.
Jeśli po tym teście pojawią się jakiekolwiek problemy, damy Ci możliwość tymczasowego wycofania się z tej zmiany. Wyślemy Ci formularz dotyczący wycofania się w dniu 6 czerwca.
Rozwiązywanie problemów
W przypadku, gdy Twoje systemy niespodziewanie mają problemy z obsługą nowego formatu tokena, możesz zarządzać transakcją (np. anulowanie/zwrot/uchwycenie) ręcznie w swoim Panelu Mollie, przechodząc do zamówień/płatności, wybierając odpowiednią transakcję i wykonując pożądaną akcję tam.
Uwaga: Organizujemy sesję Q&A 2 czerwca hostowaną na Discordzie. Dodatkowo możesz zadać wszelkie pytania w tym kanale Discord.
Terminy:
- 2 czerwca: Sesja Q&A - Dołącz do nas na Discordzie
- 5 czerwca: Pojedyncza transakcja testowa na unikalny profil/użytkownika/klient_id
- 6 czerwca: E-mail w celu dalszego działania, z możliwością tymczasowego wycofania się z nowej zmiany tokena
- 12 czerwca: Rozpoczęcie stopniowego wdrażania nowego formatu tokena (z wyłączeniem wycofań)
- 8 lipca: 100% wdrożenia nowego formatu tokena (z wyłączeniem wycofań)
-
15 września: Koniec okresu wypisania, migracja wszystkich pozostałych profili.