Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

post cover image

El uso de Idempotencia serĂĄ obligatorio

En Mercado Pago seguimos trabajando en mejorar la experiencia de nuestros integradores. En el Ășltimo tiempo, hemos visto un incremento en la duplicidad de pagos y devoluciones. Es por esto que hemos decidido hacer obligatorio el uso del header de idempotencia (X-Idempotency-Key) en las llamadas de las APIs de Pagos y de Reembolsos.

Una clave de idempotencia es un identificador Ășnico. Al incluir esta clave en el header de una solicitud de API, estĂĄs comunicando al servidor que la solicitud es idempotente; es decir, el servidor puede reconocer las solicitudes duplicadas y garantizar que sĂłlo se procese la primera.

El resultado de la operaciĂłn serĂĄ el mismo, independientemente de cuĂĄntas veces se procese la solicitud. Esto es crucial en casos de fallas de red, tiempo de espera o reenvĂ­o automĂĄtico, donde la misma solicitud puede enviarse mĂĄs de una vez.

La clave de idempotencia permite al servidor distinguir entre una nueva solicitud y una repeticiĂłn, evitando la ejecuciĂłn reiterada de la operaciĂłn asociada. Esta prĂĄctica es especialmente relevante en operaciones sensibles, como transacciones financieras, donde repeticiones no deseadas pueden causar problemas.

Si utilizas nuestros SDKs, solamente deberĂĄs actualizar la versiĂłn de los mismos a aquellas que ya incluyen el uso de idempotencia. En caso de llamar directamente a nuestras APIs, deberĂĄs generar e incluir el header de idempotencia en tus solicitudes.

La incorporaciĂłn de dicha funcionalidad serĂĄ obligatoria para todas las nuevas integraciones o implementaciones a partir del 09/01/2024, para su uso en ambientes Sandbox.

Si tu integraciĂłn es previa a dicha fecha y no tienes nuevas implementaciones, por el momento no serĂĄ obligatorio incluir la idempotencia, pero sĂ­ te recomendamos que actualices tu integraciĂłn para mejorar tu experiencia de cobros y estar al dĂ­a con las soluciones y productos de Mercado Pago.

Accede a la documentaciĂłn de las APIs de Pagos y de Reembolsos para obtener mĂĄs informaciĂłn.