Etapas de Pré-Autorização, Validação com IDPay e Autenticação da transação

1.Pré-Autorização

Ao iniciar o processo de validação, pode ocorrer uma pré-autorização no cartão de crédito do cliente.

Características importantes:

• A pré-autorização é apenas uma reserva temporária de limite
• Não representa confirmação ou captura do pagamento
• Pode ocorrer antes da etapa de autenticação antifraude
• 👉 Em termos práticos:
  o emissor do cartão apenas verifica se há limite disponível para a transação.

2. Validação com IDPAY (Resultado da Verificação)

Quando a verificação é concluída com sucesso, pode ser exibida uma mensagem informando que a validação foi finalizada.

⚠️ Essa mensagem indica apenas que:

• O processo validação foi concluído
• A validação com o antifraude IDPAY ocorreu corretamente
• ❗ Ela não representa o status final da transação.

3. Autenticação da Transação

Após a validação finalizada, ocorre a etapa de autenticação, que é responsável por validar a transação junto ao motor antifraude. Consulte a documentação Autenticação da Transação IDPAY.

A autenticação deve ser realizada através da rota:

Rota

{{urlServidor}}/v1/marketplace/transactions/:id/antifraud-auth

Atualização de Status da Transação via Webhook

evento: updated-sub-transaction

📌 O status retornado nessa etapa é o que determina se a transação foi autenticada com sucesso ou não.

4. Confirmação Final

O status final da transação deve sempre ser considerado com base no estado retornado pela API ou webhook.

• Sugestão de Fallback no fluxo transação
  • Consulte a Documentação: Fallback no fluxo transacional
• Caso o status seja diferente de: PAID e tiver ocorrido uma pré-autorização anteriormente:
  • O valor reservado será automaticamente liberado (estornado) pelo banco emissor do cartão
  • Nenhuma ação manual é necessária
  • Esse comportamento é padrão do fluxo de autorização de cartões e não depende de ação da Paytime ou do integrador.