Aktualizujemy identyfikatory upoważnień, aby korzystały z dłuższego formatu identyfikatorów API Mollie. Jest to kontynuacja wcześniejszej aktualizacji identyfikatorów API i dostosowuje upoważnienia do tego samego standardu.
Co się zmienia?
Starsze identyfikatory upoważnień zawierają 10 znaków po prefiksie mdt_. Nowo utworzone upoważnienia będą używać dłuższego identyfikatora, zawierającego do 22 znaków po prefiksie. Prefiks mdt_ pozostaje bez zmian.
Ta zmiana dotyczy nowo utworzonych upoważnień, w tym upoważnień utworzonych automatycznie za pośrednictwem płatności. Istniejące upoważnienia zachowują swoje obecne identyfikatory i nadal można z nich korzystać. Nie musisz tworzyć ich ponownie ani prosić klientów o ponowne autoryzowanie ich z powodu tej aktualizacji.
Co to oznacza?
Jeśli utrzymujesz niestandardową integrację, przejrzyj wszystkie systemy, które przechowują, weryfikują lub przekazują identyfikatory upoważnień - w tym platformy subskrypcyjne, oprogramowanie rozliczeniowe i inne połączone systemy:
- Przechowywanie w bazie danych: Zapewnij co najmniej 40 znaków dla pełnego identyfikatora, w tym jego prefiksu.
- Niestandardowa walidacja: Usuń kontrole wymagające dokładnie 10 znaków po mdt_. Jeśli weryfikujesz format, sprawdź oczekiwany prefiks bez wymuszania stałej długości pozostałej części.
- Obsługa identyfikatorów: Przechowuj i wysyłaj pełny identyfikator dokładnie w formie zwróconej przez Mollie. Traktuj go jako ciąg znaków; nie musisz go dekodować ani interpretować.
- Zgodność: Upewnij się, że Twoja integracja akceptuje zarówno istniejące krótsze identyfikatory, jak i nowe dłuższe identyfikatory.
Te zalecenia dotyczące przechowywania i walidacji są zgodne z naszymi istniejącymi wskazówkami dotyczącymi migracji identyfikatorów. Możesz również zapoznać się z dokumentacją identyfikatorów API.
Jeśli używasz wtyczki lub integracji utrzymywanej przez innego dostawcę, sprawdź u tego dostawcy, czy obsługuje ona dłuższe identyfikatory upoważnień.
Zmiana identyfikatora nie wpływa na sposób korzystania z upoważnień w przypadku płatności cyklicznych. Jednak skrócenie lub odrzucenie dłuższego identyfikatora może uniemożliwić Twojej integracji pobranie upoważnienia lub użycie go w żądaniu płatności. Jeśli napotkasz problem, sprawdź, czy pełny identyfikator jest zachowywany w całej Twojej integracji, i skontaktuj się z pomocą techniczną Mollie, podając odpowiedni błąd API oraz identyfikator upoważnienia.