We werken machtigingsidentificatoren bij zodat ze de langere API-identificatiecode-indeling van Mollie gebruiken. Dit volgt op de eerdere update van API-identificatoren en brengt machtigingen in lijn met dezelfde standaard.
Wat verandert er?
Verouderde machtigingsidentificatoren bevatten 10 tekens na het voorvoegsel mdt_. Nieuw aangemaakte machtigingen gebruiken een langere identificatiecode, met maximaal 22 tekens na het voorvoegsel. Het voorvoegsel mdt_ blijft hetzelfde.
Deze wijziging geldt voor nieuw aangemaakte machtigingen, waaronder machtigingen die automatisch via een betaling worden aangemaakt. Bestaande machtigingen behouden hun huidige identificatiecodes en blijven bruikbaar. Je hoeft ze vanwege deze update niet opnieuw aan te maken of klanten te vragen ze opnieuw te autoriseren.
Wat betekent dit voor jou?
Als je een aangepaste integratie onderhoudt, controleer dan alle systemen die machtigingsidentificatoren opslaan, valideren of doorgeven - waaronder abonnementsplatforms, factureringssoftware en andere verbonden systemen:
- Databaseopslag: Sta ten minste 40 tekens toe voor de volledige identificatiecode, inclusief het voorvoegsel.
- Aangepaste validatie: Verwijder controles die precies 10 tekens na mdt_ vereisen. 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.
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 plugin of een integratie gebruikt die door een andere provider wordt onderhouden, vraag dan bij die provider na of deze langere machtigingsidentificatoren ondersteunt.
De wijziging van de identificatiecode verandert niet hoe je machtigingen voor terugkerende betalingen gebruikt. Het inkorten of afwijzen van een langere identificatiecode kan er echter toe leiden dat je integratie geen machtiging kan ophalen of deze in een betaalverzoek kan gebruiken. 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 machtigingsidentificatiecode.