Nous mettons à jour les identifiants de mandat afin d’utiliser le format d’identifiant d’API plus long de Mollie. Cette mise à jour fait suite à la mise à jour précédente des identifiants d’API et aligne les mandats sur la même norme.
Qu’est-ce qui évolue ?
Les identifiants de mandat existants contiennent 10 caractères après le préfixe mdt_. Les mandats nouvellement créés utiliseront un identifiant plus long, comprenant jusqu’à 22 caractères après le préfixe. Le préfixe mdt_ reste inchangé.
Cette modification s’applique aux mandats nouvellement créés, y compris aux mandats créés automatiquement par le biais d’un paiement. Les mandats existants conservent leurs identifiants actuels et restent utilisables. Vous n’avez pas besoin de les recréer ni de demander aux clients de les autoriser à nouveau en raison de cette mise à jour.
Qu’est-ce que cela signifie pour vous ?
Si vous gérez une intégration personnalisée, examinez tous les systèmes qui stockent, valident ou transmettent des identifiants de mandat - y compris les plateformes d’abonnement, les logiciels de facturation et les autres systèmes connectés :
- Stockage en base de données : Prévoyez au moins 40 caractères pour l’identifiant complet, y compris son préfixe.
- Validation personnalisée : Retirez les contrôles qui exigent exactement 10 caractères après mdt_. Si vous validez le format, vérifiez le préfixe attendu sans imposer de longueur fixe pour le reste.
- Gestion des identifiants : Stockez et envoyez l’identifiant complet exactement tel que renvoyé par Mollie. Traitez-le comme une chaîne ; vous n’avez pas besoin de le décoder ni de l’interpréter.
- Compatibilité : Assurez-vous que votre intégration accepte à la fois les identifiants existants plus courts et les nouveaux identifiants plus longs.
Ces recommandations de stockage et de validation suivent nos instructions existantes relatives à la migration des identifiants. Vous pouvez également consulter la documentation sur les identifiants d’API.
Si vous utilisez un plugin ou une intégration gérée par un autre fournisseur, vérifiez auprès de ce fournisseur qu’il prend en charge les identifiants de mandat plus longs.
La modification de l’identifiant ne change pas la manière dont vous utilisez les mandats pour les paiements récurrents. Toutefois, tronquer ou rejeter un identifiant plus long pourrait empêcher votre intégration de récupérer un mandat ou de l’utiliser dans une demande de paiement. Si vous rencontrez un problème, vérifiez que l’identifiant complet est préservé dans l’ensemble de votre intégration et contactez l’assistance Mollie en indiquant l’erreur d’API concernée et l’identifiant de mandat.