Estamos actualizando los identificadores de mandato para usar el formato de identificador de API más largo de Mollie. Esto sigue la actualización anterior de los identificadores de API y adapta los mandatos al mismo estándar.
¿Qué está cambiando?
Los identificadores de mandato heredados contienen 10 caracteres después del prefijo mdt_. Los mandatos creados recientemente usarán un identificador más largo, con hasta 22 caracteres después del prefijo. El prefijo mdt_ sigue siendo el mismo.
Este cambio se aplica a los mandatos creados recientemente, incluidos los mandatos creados automáticamente mediante un pago. Los mandatos existentes conservan sus identificadores actuales y siguen siendo utilizables. No necesitas volver a crearlos ni pedir a los Clientes que los autoricen de nuevo debido a esta actualización.
¿Qué significa esto para ti?
Si mantienes una integración personalizada, revisa todos los sistemas que almacenan, validan o transmiten identificadores de mandato - incluidas las plataformas de suscripción, el software de facturación y otros sistemas conectados:
- Almacenamiento en bases de datos: Permite al menos 40 caracteres para el identificador completo, incluido su prefijo.
- Validación personalizada: Eliminar las comprobaciones que requieren exactamente 10 caracteres después de mdt_. Si validas el formato, comprueba el prefijo esperado sin imponer una longitud fija para el resto.
- Gestión de identificadores: Almacena y envía el identificador completo exactamente como lo devuelve Mollie. Trátalo como una cadena; no necesitas decodificarlo ni interpretarlo.
- Compatibilidad: Asegúrate de que tu integración acepte tanto los identificadores cortos existentes como los nuevos identificadores más largos.
Estas recomendaciones de almacenamiento y validación siguen nuestra guía existente sobre la migración de identificadores. También puedes consultar la documentación sobre identificadores de API.
Si utilizas un plugin o una integración mantenida por otro proveedor, confirma con ese proveedor que admite identificadores de mandato más largos.
El cambio de identificador no modifica cómo usas los mandatos para los Pagos recurrentes. Sin embargo, truncar o rechazar un identificador más largo podría impedir que tu integración recupere un mandato o lo use en una Solicitud de pago. Si encuentras un problema, comprueba que el identificador completo se conserve en toda tu integración y ponte en contacto con el Soporte de Mollie con el error de API y el identificador de mandato pertinentes.