Nous mettons à jour les identifiants de mandat, de client et d’abonnement afin d’utiliser le format d’identifiant API plus long de Mollie. Cette mise à jour fait suite à la mise à jour précédente des identifiants API et aligne les mandats, les clients et les abonnements 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 anciens identifiants de client contiennent 10 caractères après le préfixe cst_. Les anciens identifiants d’abonnement contiennent 10 caractères après le préfixe sub_. Les mandats, les clients et les abonnements nouvellement créés utiliseront un identifiant plus long, comportant jusqu’à 22 caractères après le préfixe correspondant. Les préfixes eux-mêmes restent identiques.
Cette modification s’applique aux mandats, aux clients et aux abonnements nouvellement créés, y compris aux mandats créés automatiquement par le biais d’un paiement. Les mandats, les clients et les abonnements existants conservent leurs identifiants actuels et restent utilisables. Vous n’avez pas besoin de les recréer, de migrer les données des clients, ni de demander aux clients d’autoriser de nouveau des mandats en raison de cette mise à jour.
Qu’est-ce que cela signifie pour vous ?
Si vous gérez une intégration personnalisée, vérifiez tous les systèmes qui stockent, valident ou transmettent des identifiants de mandat, de client ou d’abonnement — y compris les plateformes d’abonnement, les logiciels de facturation, les CRM/bases de données clients 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, pour les ID de mandat, de client et d’abonnement.
- Validation personnalisée: Retirez les vérifications qui exigent exactement 10 caractères après mdt_, cst_ ou sub_. 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 courts existants et les nouveaux identifiants plus longs, pour les mandats, les clients et les abonnements.
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 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, de client et d’abonnement plus longs.
La modification des identifiants ne change pas la manière dont vous utilisez les mandats, les clients ou les abonnements pour les paiements récurrents. Toutefois, tronquer ou rejeter un identifiant plus long pourrait empêcher votre intégration de récupérer un client, un abonnement ou 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 API et l’identifiant concernés.