Fluxo de trabalho e status de fraude
Entenda o processo de fraude da DEUNA, a análise de fornecedores e os campos de decisão de risco sem confundi-los com resultados de pagamento.
Nesta página
As decisões de fraude e os resultados dos pagamentos são independentes. Uma decisão de fraude aceita não prova que um pagamento foi autorizado, capturado ou liquidado; uma decisão de fraude rejeitada não prova que os fundos anteriormente reservados ou recolhidos foram revertidos.
Leia cada valor de seu campo real:
| Campo | Objetivo | Valores públicos |
|---|---|---|
fraud.status | Estado geral do processo de fraude. Em uma carga empacotada por pedido: order.fraud.status. | pending, in_review, accepted, rejected |
fraud.analysis.status | Status relatado para a análise do provedor selecionado. | automatic_decision, manual_review, pending_analysis, denied, accepted |
fraud.analysis.fraud_decision | Decisão de risco normalizada usada por política e roteamento. | high_risk, medium_risk, low_risk, pending_risk, manual_review, manual_denied, manual_approved |
payment.data.status | Ciclo de vida do pagamento financeiro. | Consulte Fluxo e status de pagamento. |
Não combine esses campos em uma enumeração, mesmo quando dois campos contiverem palavras semelhantes.
Processo geral de fraude#
Este diagrama aplica-se apenas a fraud.status. Os nós arredondados completam a decisão de fraude, não o ciclo de vida do pagamento.
fraud.status | Significado | Tratamento do comerciante |
|---|---|---|
pending | A triagem de fraude não produziu um resultado global. | Mantenha ativa a política de revisão configurada e avalie o estado do pagamento separadamente. |
in_review | É necessária revisão adicional ou análise assíncrona. | Aguarde uma decisão de fraude concluída. Não cumpra apenas porque o pagamento foi adiantado. |
accepted | O processo geral de fraude aceitou a transação. | Continue de acordo com a política e verifique o status real do pagamento. |
rejected | O processo geral de fraude rejeitou a transação. | Aplique a política de recusa ou reversão configurada e verifique qualquer reembolso ou anulação necessária no status do pagamento. |
Análise do provedor#
fraud.analysis.status descreve como o fornecedor antifraude selecionado produziu ou está produzindo sua análise. A API não define uma sequência de transição universal para todos os provedores, portanto, trate-os como resultados de análise do provedor – e não como uma segunda máquina de estado de pagamento.
automatic_decision diz como foi produzida a análise; não é por si só uma aprovação. Leia fraud.analysis.fraud_decision, nível de risco, pontuação e detalhes juntos. Os campos de resposta específicos do provedor podem conter valores de diagnóstico adicionais e não devem substituir os campos públicos normalizados.
Fluxos de pré-autorização e pós-autorização#
A triagem de fraude pode ser executada antes ou depois da operação do processador de acordo com a rota configurada.
Numa rejeição pós-autorização já pode existir uma autorização ou pagamento cobrado. Siga a política configurada e confirme o real payment.data.status; não presuma que a resposta à fraude resultou em anulação ou reembolso.
A seleção do provedor de fraude, o tempo pré/pós-autorização, a revisão manual e o comportamento de reversão resultante dependem da configuração do comerciante e do processador. Peça ao seu DEUNA TAM para confirmar e habilitar o comportamento requerido.
Lide com atualizações com segurança#
- Loja
fraud.status,fraud.analysis.status,fraud.analysis.fraud_decisionepayment.data.statusseparately. - Mantenha o cumprimento bloqueado enquanto a política de fraude aplicável estiver pendente ou em revisão.
- Trate a aceitação da fraude como uma permissão para continuar o fluxo configurado, e não como uma confirmação financeira.
- Após a rejeição da fraude, inspecione o histórico de pagamentos e aguarde qualquer solicitação
voidedourefundedresult. - Processe webhooks repetidos de forma idempotente e preserve as referências do provedor para reconciliação.
- Preservar valores desconhecidos e reconciliá-los; nunca mapeie um valor de fraude desconhecido para o sucesso do pagamento.
Consulte Fluxo e status de pagamento para transições financeiras e Webhooks da DEUNA para configuração de notificação.