Aktualisierung der API-Kennungen für Mandate.

Wir aktualisieren Mandatskennungen auf das längere API-Kennungsformat von Mollie. Dies folgt der früheren Aktualisierung der API-Kennungen und bringt Mandate auf denselben Standard.
 

Was ändert sich?

Bisherige Mandatskennungen enthalten 10 Zeichen nach dem Präfix mdt_. Neu erstellte Mandate verwenden eine längere Kennung, mit bis zu 22 Zeichen nach dem Präfix. Das Präfix mdt_ bleibt unverändert.

Diese Änderung gilt für neu erstellte Mandate, einschließlich Mandate, die automatisch über eine Zahlung erstellt werden. Bestehende Mandate behalten ihre aktuellen Kennungen und bleiben verwendbar. Sie müssen sie aufgrund dieser Aktualisierung nicht neu erstellen oder Kunden bitten, sie erneut zu autorisieren.

 

Was bedeutet das für Sie?

Wenn Sie eine individuelle Integration betreuen, überprüfen Sie alle Systeme, die Mandatskennungen speichern, validieren oder weiterleiten - einschließlich Abonnementplattformen, Abrechnungssoftware und anderer verbundener Systeme:

  • Datenbankspeicherung: Reservieren Sie mindestens 40 Zeichen für die vollständige Kennung, einschließlich ihres Präfixes.
  • Benutzerdefinierte Validierung: Entfernen Sie Prüfungen, die nach mdt_ genau 10 Zeichen verlangen. Wenn Sie das Format validieren, prüfen Sie das erwartete Präfix, ohne für den Rest eine feste Länge vorzuschreiben.
  • Umgang mit Kennungen: Speichern und senden Sie die vollständige Kennung genau so, wie sie von Mollie zurückgegeben wird. Behandeln Sie sie als Zeichenfolge; Sie müssen sie weder decodieren noch interpretieren.
  • Kompatibilität: Stellen Sie sicher, dass Ihre Integration sowohl vorhandene kürzere als auch neue längere Kennungen akzeptiert.

Diese Empfehlungen zur Speicherung und Validierung folgen unserer bestehenden Anleitung zur Migration von Kennungen. Sie können auch die Dokumentation zu API-Kennungen konsultieren.

Wenn Sie ein Plugin oder eine von einem anderen Anbieter gepflegte Integration verwenden, klären Sie mit diesem Anbieter, ob diese längere Mandatskennungen unterstützt.

Die Änderung der Kennungen verändert nicht, wie Sie Mandate für wiederkehrende Zahlungen verwenden. Das Kürzen oder Ablehnen einer längeren Kennung könnte jedoch verhindern, dass Ihre Integration ein Mandat abruft oder es in einer Zahlungsaufforderung verwendet. Wenn ein Problem auftritt, prüfen Sie, ob die vollständige Kennung in Ihrer gesamten Integration erhalten bleibt, und kontaktieren Sie den Mollie Support mit dem relevanten Fehler der API und der Mandatskennung.