Wir aktualisieren Mandats-, Kunden-, und Abonnementkennungen, damit sie Mollies längeres API-Kennungsformat verwenden. Dies folgt der früheren Aktualisierung der API-Kennungen und bringt Mandate, Kunden, und Abonnements auf denselben Standard.
Was ändert sich?
Bisherige Mandatskennungen enthalten 10 Zeichen nach dem Präfix mdt_. Ältere Kundenkennungen enthalten 10 Zeichen nach dem Präfix cst_. Ältere Abonnementkennungen enthalten 10 Zeichen nach dem Präfix sub_. Neu erstellte Mandate, Kunden, und Abonnements verwenden eine längere Kennung, mit bis zu 22 Zeichen nach dem jeweiligen Präfix. Die Präfixe selbst bleiben unverändert.
Diese Änderung gilt für neu erstellte Mandate, Kunden, und Abonnements, einschließlich Mandaten, die automatisch durch eine Zahlung erstellt werden. Bestehende Mandate, Kunden, und Abonnements behalten ihre aktuellen Kennungen und bleiben nutzbar. Sie müssen sie aufgrund dieser Aktualisierung nicht neu erstellen, Kundendatensätze migrieren, oder Kunden bitten, Mandate erneut zu autorisieren.
Was bedeutet das für Sie?
Wenn Sie eine benutzerdefinierte Integration pflegen, prüfen Sie alle Systeme, die Mandats-, Kunden-, oder Abonnementkennungen speichern, validieren, oder weitergeben — einschließlich Abonnementplattformen, Abrechnungssoftware, CRM-/Kundendatenspeicher, und anderer verbundener Systeme:
- Datenbankspeicherung: Ermöglichen Sie mindestens 40 Zeichen für die vollständige Kennung, einschließlich ihres Präfixes, für Mandats-, Kunden-, und Abonnement-IDs.
- Benutzerdefinierte Validierung: Entfernen Sie Prüfungen, die nach mdt_, cst_, oder sub_ genau 10 Zeichen erfordern. 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 bestehende kürzere Kennungen als auch neue längere Kennungen akzeptiert, für Mandate, Kunden, und Abonnements.
Diese Empfehlungen zur Speicherung und Validierung folgen unserer bestehenden Anleitung zur Migration von Kennungen. Sie können auch die Dokumentation zu API-Kennungen einsehen.
Wenn Sie ein Plugin oder eine von einem anderen Anbieter gepflegte Integration verwenden, klären Sie mit diesem Anbieter die Unterstützung längerer Mandats-, Kunden-, und Abonnementkennungen.
Die Änderung der Kennungen verändert nicht, wie Sie Mandate, Kunden, oder Abonnements für Wiederkehrende Zahlungen verwenden. Das Kürzen oder Ablehnen einer längeren Kennung könnte jedoch verhindern, dass Ihre Integration einen Kunden, ein Abonnement, oder ein Mandat abruft, oder die Kennung in einer Zahlungsaufforderung verwendet. Wenn Sie auf ein Problem stoßen, prüfen Sie, ob die vollständige Kennung in Ihrer gesamten Integration erhalten bleibt, und kontaktieren Sie den Mollie-Support mit dem relevanten API-Fehler und der Kennung.