We werken identificatiecodes voor machtigingen, klanten en abonnementen bij naar de langere notatie van Mollie voor API-identificatiecodes. Dit volgt op de eerdere update van API-identificatiecodes en brengt machtigingen, klanten en abonnementen in lijn met dezelfde standaard.
Wat verandert er?
Verouderde machtigingsidentificatoren bevatten 10 tekens na het voorvoegsel mdt_. Verouderde klantidentificatiecodes bevatten 10 tekens na het cst_-voorvoegsel. Oude abonnementsidentificatiecodes bevatten 10 tekens na het sub_-voorvoegsel. Nieuw aangemaakte machtigingen, klanten en abonnementen gebruiken een langere identificatiecode, met maximaal 22 tekens na het betreffende voorvoegsel. De voorvoegsels zelf blijven hetzelfde.
Deze wijziging geldt voor nieuw aangemaakte machtigingen, klanten en abonnementen, inclusief machtigingen die automatisch via een betaling worden aangemaakt. Bestaande machtigingen, klanten en abonnementen behouden hun huidige identificatiecodes en blijven bruikbaar. Je hoeft ze niet opnieuw aan te maken, klantgegevens te migreren of klanten door deze update opnieuw te vragen machtigingen te autoriseren.
Wat betekent dit voor jou?
Als je een aangepaste integratie onderhoudt, controleer dan alle systemen die identificatiecodes voor machtigingen, klanten of abonnementen opslaan, valideren of doorgeven — inclusief abonnementsplatforms, factureringssoftware, CRM-/klantgegevensopslag en andere verbonden systemen:
- Databaseopslag: Sta minstens 40 tekens toe voor de volledige identificatiecode, inclusief het voorvoegsel, voor identificatiecodes van machtigingen, klanten en abonnementen.
- Aangepaste validatie: Verwijder controles die precies 10 tekens vereisen na mdt_, cst_ of sub_. Als je de indeling valideert, controleer dan het verwachte voorvoegsel zonder een vaste lengte voor de rest af te dwingen.
- Identificatiecodes verwerken: Sla de volledige identificatiecode op en verstuur deze precies zoals Mollie die retourneert. Behandel deze als een tekenreeks; je hoeft deze niet te decoderen of te interpreteren.
- Compatibiliteit: Zorg ervoor dat je integratie zowel bestaande kortere identificatiecodes als nieuwe langere identificatiecodes accepteert, voor machtigingen, klanten en abonnementen.
Deze aanbevelingen voor opslag en validatie volgen onze bestaande richtlijnen voor de migratie van identificatiecodes. Je kunt ook de documentatie over API-identificatiecodes raadplegen.
Als je een plug-in of een integratie gebruikt die door een andere aanbieder wordt onderhouden, controleer dan bij die aanbieder of deze langere identificatiecodes voor machtigingen, klanten en abonnementen ondersteunt.
De wijziging van de identificatiecodes verandert niets aan de manier waarop je machtigingen, klanten of abonnementen voor terugkerende betalingen gebruikt. Echter, het inkorten of weigeren van een langere identificatiecode kan voorkomen dat je integratie een klant, abonnement of machtiging ophaalt of deze in een betaalverzoek gebruikt. Als je een probleem ondervindt, controleer dan of de volledige identificatiecode in je hele integratie behouden blijft en neem contact op met Mollie Support met de relevante API-fout en identificatiecode.