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 dotyczyć naszych najważniejszych zasobów: Płatności (Utwórz płatność -> Odpowiedź -> ID) oraz 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, ta zmiana nie powinna mieć na Ciebie wpływu. 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. Dodatkowe informacje o nowym standardzie znajdziesz 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
Jeśli Twoje systemy niespodziewanie będą miały trudności z obsługą nowego formatu tokena, możesz zarządzać transakcją (np. anuluj/zwrot/pobierz) ręcznie w Panelu Mollie, przechodząc do Zamówienia/Sprzedaż, wybierając odpowiednią transakcję i wykonując tam żądaną czynność.
Uwaga: Organizujemy sesję pytań i odpowiedzi 2 czerwca na Discordzie. Dodatkowo, możesz zadać dowolne pytania na tym kanale Discord.
Terminy:
- 2 czerwca: Sesja pytań i odpowiedzi - 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ń)
-
31 grudnia: Koniec okresu rezygnacji, migracja wszystkich pozostałych profili.