Versiones del API

La API Transaccional se publica por versiones. Eliges la versión con el header X-Api-Version en cada petición: no necesitas otra URL ni otras credenciales. Si no envías el header, la API responde con la versión 1, así que las integraciones existentes siguen funcionando sin cambios.

Versiones disponibles

Versión	Estado
v2	Recomendada
v1	Por defecto

La versión v2 es la recomendada para integraciones nuevas.

Cómo elegir la versión

Agrega el header X-Api-Version a la petición:

Copiar código

Solo el valor exacto 2 activa la versión 2

Solo el valor exacto 2 activa la versión 2. Cualquier otro valor (por ejemplo 2.0, v2 o 02), o la ausencia del header, se atiende como versión 1 sin devolver un error. Si tu petición v2 se comporta como v1, revisa que el header se envíe tal cual: X-Api-Version: 2.

Siguientes pasos

• Revisa qué trae cada versión en el Registro de cambios.
• Si ya tienes una integración en v1, sigue la guía Migrar de v1 a v2.