Estamos actualizando los identificadores de mandatos, clientes y suscripciones para utilizar el formato de identificador de API más largo de Mollie. Esto sigue a la actualización anterior de los identificadores de API y adapta los mandatos, clientes y suscripciones al mismo estándar.
¿Qué está cambiando?
Los identificadores de mandato heredados contienen 10 caracteres después del prefijo mdt_. Los identificadores de clientes heredados contienen 10 caracteres después del prefijo cst_. Los identificadores de suscripciones heredados contienen 10 caracteres después del prefijo sub_. Los mandatos, clientes y suscripciones creados recientemente utilizarán un identificador más largo, con hasta 22 caracteres después del prefijo correspondiente. Los prefijos se mantienen iguales.
Este cambio se aplica a los mandatos, clientes y suscripciones creados recientemente, incluidos los mandatos creados automáticamente mediante un pago. Los mandatos, clientes y suscripciones existentes conservan sus identificadores actuales y siguen siendo utilizables. No necesitas volver a crearlos, migrar los registros de clientes ni pedir a los clientes que autoricen los mandatos de nuevo debido a esta actualización.
¿Qué significa esto para ti?
Si mantienes una integración personalizada, revisa los sistemas que almacenan, validan o transmiten identificadores de mandatos, clientes o suscripciones — incluidas las plataformas de suscripciones, el software de facturación, los almacenes de datos de CRM/clientes y otros sistemas conectados:
- Almacenamiento en base de datos: Permite al menos 40 caracteres para el identificador completo, incluido su prefijo, para los ID de mandatos, clientes y suscripciones.
- Validación personalizada: Eliminar las comprobaciones que requieren exactamente 10 caracteres después de mdt_, cst_ o sub_. 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 más cortos existentes como los nuevos identificadores más largos, para mandatos, clientes y suscripciones.
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 de identificadores de API.
Si utilizas un plugin o una integración mantenida por otro proveedor, confirma con ese proveedor que admite identificadores más largos de mandatos, clientes y suscripciones.
El cambio de identificador no altera cómo utilizas los mandatos, clientes o suscripciones para los pagos recurrentes. Sin embargo, truncar o rechazar un identificador más largo podría impedir que tu integración recupere un cliente, una suscripción o un mandato, o que lo utilice en una solicitud de pago. Si encuentras un problema, comprueba que el identificador completo se conserve en toda tu integración y contacta con el equipo de Soporte de Mollie con el error de API y el identificador pertinentes.