# Actualizaciones de API Mantente al tanto de los cambios y actualizaciones de la API de Stripe. > [Eventos ligeros](https://docs.stripe.com/event-destinations.md#thin-events) para los recursos API v1 están disponibles en versión preliminar privada. Puedes usarlos para optimizar las actualizaciones de integración sin cambiar la configuración de tu webhook. Anteriormente, los eventos ligeros solo admitían recursos API v2. [Más información y solicitud de acceso](https://docs.google.com/forms/d/e/1FAIpQLSeEkqzB02afvlklMkqwA6wsBH90eW8gxmc-hBOvqe2N6TRujQ/viewform?usp=dialog). Tu versión de API controla el comportamiento de la API y del webhook que ves (por ejemplo, qué parámetros puedes incluir en las solicitudes, qué propiedades ves en las respuestas, etc.). Tu versión se establece la primera vez que realizas una solicitud a la API. Cada versión principal, como [Acacia](https://docs.stripe.com/changelog/acacia.md), incluye cambios que no son compatibles con versiones anteriores. La actualización a una nueva versión principal puede requerir actualizaciones en el código existente. Cada versión mensual incluye solo cambios compatibles con versiones anteriores y utiliza el mismo nombre que la última versión principal. Puedes actualizar de forma segura a una nueva versión mensual sin romper ningún código existente. Para actualizar tu versión de API, sigue [estos pasos](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api). Cuando una plataforma [Connect](https://stripe.com/connect) realiza solicitudes en nombre de cuentas conectadas sin especificar una versión de API, Stripe siempre utiliza la versión de la API de la plataforma. Independientemente de la versión de la API de una cuenta conectada, las solicitudes de la plataforma en su nombre siempre devuelven respuestas que coinciden con la versión de la API de la solicitud. ## Cambios compatibles con versiones anteriores Stripe considera que los siguientes cambios son compatibles con versiones anteriores: - Agregado de nuevos recursos de API. - Agregado de nuevos parámetros de solicitud opcionales para los métodos actuales de API. - Agregado de nuevas propiedades a las respuestas actuales de API. - Cambio del orden de las propiedades en las respuestas actuales de API. - Cambio de la longitud del formato de las cadenas opacas, como las ID de objeto, los mensajes de error y otras cadenas en lenguaje natural. - Esto incluye agregar o quitar prefijos fijos (como `ch_` en la identificación de cargos). - Asegúrate de que tu integración pueda manejar ID de objetos generados por Stripe, que pueden contener hasta 255 caracteres. Por ejemplo, si utilizas MySQL, almacena las ID en una columna `VARCHAR(255) COLLATE utf8_bin` (la configuración `COLLATE`COLLATE` distingue entre mayúsculas y minúsculas durante las búsquedas). - Agregado de nuevos tipos de eventos. - Asegúrate de que tu receptor de webhook maneje correctamente tipos de eventos desconocidos. ## Actualiza tu versión de API Si estás ejecutando una versión anterior de la API, actualiza a la versión más reciente para aprovechar las nuevas características y funcionalidades mejoradas. La actualización de tu versión de API afecta a: - Las llamadas de API que se realicen sin un encabezado `Stripe-Version`: los parámetros que puedas enviar y la estructura de los objetos devueltos. - La estructura de los objetos recibidos con métodos de [Stripe.js](https://docs.stripe.com/payments/elements.md) como [confirmCardPayment](https://docs.stripe.com/js.md#stripe-confirm-card-payment). - La estructura de los objetos enviados a los puntos de conexión del webhook (tanto Account como [Connect](https://docs.stripe.com/connect/webhooks.md)). Sin embargo, si un punto de conexión tiene un conjunto de versiones explícito, siempre usa esa versión. - Las operaciones de facturación automatizada realizadas por Stripe (por ejemplo, generar una *factura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) para un nuevo período de suscripción) utilizan la versión predeterminada de la API de tu cuenta. Consulta el registro de cambios de la API para obtener más información sobre cómo afecta tu versión predeterminada de la API a estas operaciones. ### Ver la versión de la API y la última actualización disponible en Workbench Consulta la [versión de la API utilizada por las solicitudes recientes](https://docs.stripe.com/workbench/guides.md#view-api-versions) de tu cuenta y la última actualización disponible en la pestaña [Resumen](https://dashboard.stripe.com/workbench/overview) de Workbench. Al realizar una actualización de la API, asegúrate de especificar en la programación la versión de la API que te sirve de comparación en tu integración, en lugar de confiar en la versión predeterminada de la API de tu cuenta. Para probar una versión más reciente de las llamadas API, configura el encabezado `Stripe-Version` (en modo activo o de prueba). Obtén información sobre cómo administrar el control de versiones en nuestras [SDK del lado del servidor](https://docs.stripe.com/sdks.md#server-side-libraries). ### Actualiza y prueba tus webhooks Consulta nuestra guía sobre [cómo manejar el control de versiones de webhooks](https://docs.stripe.com/webhooks/versioning.md). ### Realizar la actualización Cuando estés seguro de que tu código puede manejar la última versión de la API, realiza la actualización utilizando Workbench: 1. Abre la pestaña [Resumen](https://dashboard.stripe.com/workbench/overview) en Workbench. 1. En la sección **versiones de API**, haz clic en **Actualización disponible**, que es visible si hay disponible una versión más reciente de la API. 1. Revisa qué versión de API se asignará a tu cuenta y haz clic en **Actualizar**. Esto cambia la versión utilizada por las llamadas API que no tienen el encabezado `Stripe-Version` y también cambia la versión utilizada para representar los objetos enviados a tus webhooks. > La forma de los recursos dentro de [los eventos recuperados de la API](https://docs.stripe.com/api/events.md) está definida por la versión predeterminada de la API de tu cuenta en el momento en que se produjo el evento. Si el código recupera eventos creados cuando la versión predeterminada de la API era diferente, debe tener en cuenta las diferencias en las versiones de los eventos. ### Revierte tu versión de API Durante las 72 horas posteriores a la actualización de la versión de la API, puedes volver a la versión anterior sin correr riesgos desde Workbench. Una vez que hayas revertido la versión, los webhooks enviados con la nueva estructura de objetos que fallaron se volverán a enviar con la estructura anterior. ## Mantente informado Enviamos información sobre nuevas incorporaciones y cambios en la API Stripe y las bibliotecas de lenguajes en el Developer Digest de Stripe. Asegúrate de [suscribirte](https://go.stripe.global/dev-digest) para estar informado sobre las incorporaciones y los cambios. ## Versiones de API > Esta sección ya no se actualiza. Para obtener información sobre las actualizaciones de la API de Stripe, visita el nuevo [Registro de cambios](https://docs.stripe.com/changelog.md). A continuación, se enumeran todos los [cambios rotundos](https://docs.stripe.com/upgrades.md#breaking-change) realizados a la API de Stripe. Cada fecha corresponde a una nueva versión de la API. Si quieres conocer lo que se agregó a la API y sus actualizaciones, consulta el [registro de cambios de la API](https://docs.stripe.com/changelog.md). Si te interesan nuevos lanzamientos de productos, consulta el [registro de cambios de productos](https://stripe.com/blog/changelog).