Há uma série de funcionalidades que ajudam a garantir uma experiência de pagamento sem atritos para o consumidor no ambiente digital.

Checkout transparente, retentativa de pagamento e compra com um clique são algumas das mais comuns. Mas você conhece a idempotência?

Na prática, essa propriedade garante que o seu e-commerce não realize cobranças duplicadas, por falhas na comunicação entre a loja e a aplicação. Assim, você proporciona uma experiência de compra mais fluida e satisfatória ao cliente.

Continue a leitura para entender melhor o que é idempotência e como funciona esse recurso disponível no gateway de pagamento do Pagar.me!

O que é idempotência?

A idempotência é um conceito da área de matemática e ciência da computação, que se refere à possibilidade de uma determinada operação ser aplicada múltiplas vezes e, em todas elas, obter um único resultado.

Em outras palavras, se os parâmetros forem os mesmos, a operação sempre levará ao mesmo resultado, independentemente do número de vezes que ela for executada.

Pensando no contexto de uma API, a idempotência garante que uma requisição seja concluída uma só vez, ou seja, mesmo que sejam realizadas requisições idênticas dentro de um certo período de tempo, elas terão apenas uma resposta.

Como funciona a idempotência no Pagar.me?

A API Pagar.me, utilizada para implementar a nossa solução de gateway de pagamento, conta com a funcionalidade de idempotência na criação de pedidos.

Isso significa que não há o risco de criar transações duplicadas, no caso de erros de comunicação entre o e-commerce e a nossa tecnologia, nos quais não há resposta da criação do pedido, por exemplo.

Imagine que uma loja gere duas requisições idênticas, em um curto período de tempo. Com a idempotência, a aplicação devolve a mesma resposta para as duas solicitações, criando uma única transação.

Como utilizar a idempotência nas transações processadas pelo Pagar.me?

Para utilizar a idempotência, basta utilizar uma chave Idempotency-key no header da requisição. Essa chave deve ser gerada pelo próprio lojista e expira 24 horas após o envio do primeiro pedido.

É importante ter em mente que a Idempotency-key é escrita no formato case-sensitive, ou seja, o uso de letras maiúsculas e minúsculas faz diferença na criação da chave. Além disso, é recomendável não enviar chaves muito longas, para não comprometer o tempo de resposta da aplicação.

O Pagar.me armazena essa chave, assim como o status retornado para a transação (capturada, autorizada ou falha, por exemplo).

A partir disso, qualquer requisição realizada com a mesma chave, em até 24 horas após a criação do primeiro pedido, terá como resposta uma única transação, evitando a duplicação das requisições.

Para entender mais a fundo como funciona a idempotência na nossa API e como gerar as chaves para as suas transações, consulte a documentação do Pagar.me.

Se quiser contar com essa funcionalidade no seu e-commerce, cadastre-se no Pagar.me ou entre em contato para receber uma proposta personalizada para as necessidades do seu negócio!