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.
ÂżTe sirviĂł esta informaciĂłn?
SĂ
No