Como parte de los esfuerzos de Mollie para mejorar la confiabilidad y seguridad de nuestros sistemas, estamos trabajando en unificar nuestros identificadores de recursos de API bajo un nuevo estándar: los identificadores de pagos y pedidos están próximos en la lista.
¿Qué está evolucionando?
Históricamente, nuestros identificadores de API consistían en 10 caracteres o menos (excluyendo el prefijo, ejemplo: tr_XYZXYZXYZX). Desde principios de año, hemos estado actualizando estos identificadores heredados a un formato más largo, agregando de 4 a 12 caracteres adicionales.
Recursos más nuevos - como Capturas y Enlaces de Pago - se introdujeron utilizando este formato extendido desde el principio. Reembolsos, un recurso más antiguo, fueron recientemente actualizados para adoptar el nuevo formato.
A continuación, este cambio se aplicará a nuestros recursos más críticos: Pagos (Crear pago -> Respuesta -> ID) y Pedidos (Crear pedido -> Respuesta -> ID).
¿Qué significa esto para ti?
Si usas una de nuestras integraciones predefinidas, como WooCommerce, Shopify o Magento 2, no deberías ver ningún impacto por este cambio. Revisamos estas integraciones y no hemos identificado ningún problema de compatibilidad.
Sin embargo, si tienes una integración personalizada con Mollie y/o integraciones adicionales continuas que manejen estas referencias de pago (por ejemplo, ERP, gestión de pedidos o sistemas contables), por favor, tómate un momento para revisar lo siguiente:
- Almacenamiento en base de datos: Si almacenas estos identificadores, asegúrate de que la longitud del campo no esté limitada a solo 10 caracteres. Recomendamos una longitud de campo de al menos 40 caracteres o más para asegurarte para el futuro.
- Validación personalizada: Asegúrate de que cualquier validación de identificadores personalizados que tengas pueda acomodar el formato más largo. Recomendamos que si decides validar el formato del token, solo verifiques que el prefijo coincida con tus expectativas y evites validar el resto del token.
Esta actualización no debería interrumpir el procesamiento de pagos, pero un manejo incorrecto de los nuevos identificadores podría llevar a discrepancias. Puedes encontrar más información sobre el nuevo estándar aquí.
Prepárate para una transacción de prueba:
Realizaremos una única transacción de prueba en cada combinación única de perfil/user_agent/client_id utilizando los nuevos identificadores de API el 5 de junio, comenzando a las 2 am CET. Por lo tanto, enrutamos la primera transacción que se realice para utilizar el nuevo formato de token. Todas las transacciones subsiguientes utilizarán el antiguo estándar nuevamente, hasta que comencemos el despliegue el 12 de junio.
Si surgen problemas después de esta prueba, te daremos la opción de optar temporalmente por salir del cambio. Te enviaremos un correo electrónico con un formulario respecto a la exclusión el 6 de junio.
Solución de problemas
Si tus sistemas tienen problemas inesperados al manejar el nuevo formato de token, puedes gestionar la transacción (por ejemplo, cancelar/reembolsar/cobro) manualmente en tu Dashboard Mollie navegando a Pedidos/Ventas, seleccionando la transacción relevante y realizando la acción deseada allí.
Nota: Organizamos una sesión de preguntas y respuestas el 2 de junio en Discord. Además, puedes hacer cualquier pregunta en este canal de Discord.
Fechas importantes:
- 2 de junio: Sesión de preguntas y respuestas - Únete en Discord
- 5 de junio: Transacción de prueba única por combinación única de perfil/user-agent/client_id
- 6 de junio: Correo electrónico de seguimiento, con opción de optar temporalmente por salir del nuevo cambio de tokens
- 12 de junio: Comienzo del despliegue gradual del nuevo formato de token (excl. exclusiones)
- 8 de julio: 100% despliegue del nuevo formato de token (excl. exclusiones)
-
31 de diciembre: Fin del período de exclusión, migración de todos los perfiles restantes.