Aktualizujemy identyfikatory upoważnień, klientów i subskrypcji, 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, Klientów i subskrypcje do tego samego standardu.
Co się zmienia?
Starsze identyfikatory upoważnień zawierają 10 znaków po prefiksie mdt_. Starsze identyfikatory klientów zawierają 10 znaków po prefiksie cst_. Starsze identyfikatory subskrypcji zawierają 10 znaków po prefiksie sub_. Nowo utworzone upoważnienia, klienci i subskrypcje będą korzystać z dłuższego identyfikatora, zawierającego do 22 znaków po odpowiednim prefiksie. Same prefiksy pozostają bez zmian.
Ta zmiana dotyczy nowo utworzonych upoważnień, Klientów i subskrypcji, w tym upoważnień utworzonych automatycznie za pośrednictwem płatności. Istniejące upoważnienia, klienci i subskrypcje zachowują swoje obecne identyfikatory i nadal można z nich korzystać. Nie musisz tworzyć ich ponownie, migrować danych Klientów ani ponownie prosić Klientów o autoryzację upoważnień z powodu tej aktualizacji.
Co to oznacza?
Jeśli utrzymujesz niestandardową Integrację, sprawdź wszystkie systemy, które przechowują, walidują lub przekazują identyfikatory upoważnień, Klientów lub subskrypcji — w tym platformy subskrypcyjne, oprogramowanie rozliczeniowe, magazyny danych CRM/danych Klientów i inne połączone systemy:
- Przechowywanie w bazie danych: Zapewnij co najmniej 40 znaków dla pełnego identyfikatora, w tym jego prefiksu, dla identyfikatorów upoważnień, klientów i subskrypcji.
- Niestandardowa walidacja: Usuń kontrole wymagające dokładnie 10 znaków po mdt_, cst_ lub sub_. 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 dla upoważnień, Klientów i subskrypcji.
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 korzystasz z wtyczki lub Integracji utrzymywanej przez innego dostawcę, sprawdź u tego dostawcy, czy obsługuje ona dłuższe identyfikatory upoważnień, Klientów i subskrypcji.
Zmiana identyfikatorów nie zmienia sposobu korzystania z upoważnień, Klientów ani subskrypcji w przypadku Płatności cyklicznych. Jednak skrócenie lub odrzucenie dłuższego identyfikatora może uniemożliwić Twojej Integracji pobranie Klienta, subskrypcji lub upoważnienia albo użycie go we Wniosku o płatność. Jeśli napotkasz problem, sprawdź, czy pełny identyfikator jest zachowany w całej Integracji, i skontaktuj się z pomocą techniczną Mollie, podając odpowiedni błąd API i identyfikator.