Descontinuação da solução de idempotência antiga da Adyen

Por que estamos mudando nossa solução de idempotência?

A Adyen desenvolveu uma nova estrutura de idempotência que é capaz de expandir de forma otimizada com o crescimento da sua plataforma. Essa nova estrutura permite um processamento mais síncrono, melhor lógica nas novas tentativas e maior resiliência.

Com ela, a Adyen descontinuará a solução de idempotência anterior. Os comerciantes que fazem uso da solução antiga precisarão reavaliar sua integração e fazer as atualizações necessárias.

 

Qual é o cronograma dessa mudança?

A descontinuação da solução antiga será feita em duas etapas:  

  • Ambiente de teste – descontinuação da solução antiga até quarta-feira, 1º de julho
  • Ambiente de produção – descontinuação da solução antiga até terça-feira, 15 de setembro

A nova estrutura já está disponível para os comerciantes nos ambientes de teste e produção. Segue abaixo o cronograma das duas etapas de migração:

 

Até 30 de junho de 2020

1º de julho de 2020

Até 14 de setembro de 2020

15 de setembro de 2020

Ambiente de teste

Os comerciantes atualizam a estrutura de teste e migram para a nova solução

A Adyen descontinua a solução antiga

   

Ambiente de produção

    

Os comerciantes atualizam a estrutura e migram para a nova solução

A Adyen descontinua a solução antiga

 

Quais são as principais diferenças técnicas entre as duas soluções de idempotência?

A tabela abaixo dá uma visão geral das principais diferenças técnicas:

 

Estrutura de idempotência antiga

Estrutura de idempotência nova

cabeçalho de solicitação http

– Usa uma chave pragma http com um valor de cabeçalho da diretiva pragma

– Usa uma chave de idempotência http com um identificador exclusivo (fornecido pelo comerciante)

– O cabeçalho é incluído apenas em novas tentativas

– O cabeçalho é enviado em todas as solicitações

– O uso do cabeçalho muda o processamento de síncrono para assíncrono

– O uso do cabeçalho não afeta o processamento síncrono

Tratamento de novas tentativas

– Envia uma notificação de código de evento PROCESS_RETRY juntamente com a notificação regular das solicitações

– Envia a notificação regular usada para solicitações de autorização

Tratamento de erros

– Não se aplica

– Fornece erros de resposta para melhorar a lógica das novas tentativas

Identificador exclusivo da transação

– Usa a conta do comerciante e uma referência exclusiva do comerciante para identificar uma transação específica

– Usa uma chave de idempotência criada pelo comerciante, normalmente gerada através do tipo UUID versão 4 (aleatório)

*O serviço de idempotência da Adyen é específico para cada país. Portanto, as chaves de idempotência exclusivas fornecidas pelo comerciante não devem ser usadas em várias países, caso você esteja processando em mais de um país.

 

Onde posso encontrar mais informações sobre a solução de idempotência mais recente da Adyen?

Há mais informações disponíveis em nossa documentação, que você pode encontrar na página de documentos da Adyen aqui: Idempotência de API.

O serviço de idempotência da Adyen é específico por país. Portanto, as chaves de idempotência exclusivas fornecidas pelo comerciante não devem ser usadas em vários países, caso você esteja processando em mais de um país.

Para saber mais sobre chaves de idempotência, consulte esta página: escopo e validade das chaves.

 

Quais são as próximas etapas necessárias para fazer essa mudança?

Nossa nova estrutura de idempotência já está disponível nos ambientes de teste e produção. Sua equipe técnica ou seu integrador já podem começar a verificar a integração dos seus pagamentos para avaliar as alterações necessárias e testá-las em nossos endpoints.

Esse artigo foi útil?
Usuários que acharam isso útil: 2 de 8