Skip to main content
Abaixo estão os principais erros que podem acontecer durante uma transação com 3DS, para te ajudar a identificar e entender melhor cada situação.

Retentativas e SetupId

Importante: Se uma transação 3DS2 falhar por qualquer motivo (timeout, erro de tokenização, erro de autenticação, etc.), não é permitido reutilizar o mesmo setupId para tentar novamente. O setupId retornado no setup é válido apenas para uma única tentativa de cobrança. Para retentar uma transação que falhou, você deve:
  1. Criar um novo setup — Chame novamente o endpoint POST /v1/charges/3ds/setup para obter um novo setupId Veja aqui como criar o setup
  2. Realizar nova coleta de dados — Execute novamente a etapa de coleta de dados do dispositivo (Passo 2)
  3. Criar nova cobrança — Crie uma nova cobrança usando o novo setupId obtido
Tentar reutilizar o mesmo setupId em uma retentativa resultará em erro e impedirá o processamento da transação.