No Mercado Pago seguimos trabalhando para melhorar a experiência dos nossos integradores. Recentemente, observamos um aumento na duplicação de pagamentos e reembolsos, por isso decidimos tornar obrigatório o uso do header de idempotência (X-Idempotency-Key) nas chamadas às APIs de Pagamentos e Reembolsos.

Uma chave de idempotência é um identificador único. Ao incluir essa chave no header de uma requisição de API, você está comunicando ao servidor que essa requisição é idempotente, ou seja, o servidor pode reconhecer as requisições duplicadas e garantir que apenas a primeira seja processada.

O resultado da operação será o mesmo, independentemente do número de vezes que a solicitação foi processada. Isso é crucial em casos de falhas de rede, timeouts ou reenvios automáticos, onde a mesma requisição pode ser enviada mais de uma vez.

A chave de idempotência permite ao servidor distinguir entre uma nova requisição e uma repetição, evitando a execução repetida da operação associada. Essa prática é especialmente relevante em operações sensíveis, como transações financeiras, onde repetições indesejadas podem causar problemas.

Se você estiver utilizando nossos SDKs, basta atualizar a versão para aquelas que já incluem o uso de idempotência. Se estiver fazendo chamadas diretamente às nossas APIs, você precisará gerar e incluir a chave de idempotência no header de suas chamadas.

A incorporação desta funcionalidade será obrigatória para todas as novas integrações ou implementações a partir de 09/01/2024, para uso em ambiente Sandbox.

Se sua integração for anterior a essa data e você não terá novas implementações, por enquanto, não será obrigatório incluir a idempotência, mas recomendamos que você atualize sua integração para melhorar a experiência de cobrança e estar atualizado com as soluções e produtos do Mercado Pago.

Acesse a documentação APIs de Pagamentos e Reembolsos para saber mais.