Anotar avaliações com eventos de transação

Esta página descreve como anotar avaliações com eventos de transação para refinar seu modelo específico do site.

Para ter o melhor desempenho, a prevenção contra fraudes do reCAPTCHA precisa de visibilidade em eventos de ciclo de vida de pagamento para transações. Portanto, recomendamos que você envie anotações para as avaliações que criou com dados de transação. Por exemplo, é possível fornecer as informações da transação para a Prevenção contra fraudes do reCAPTCHA como um evento de transação nos seguintes cenários:

  • O provedor de pagamento aceita ou recusa a transação.

  • O comerciante emite um reembolso.

  • O emissor do pagamento solicita um reembolso.

Para saber mais sobre como enviar anotações, consulte Anotar avaliações.

Recomendamos que você faça essas solicitações automaticamente como parte da lógica correspondente no seu sistema quando os dados estiverem disponíveis, como quando o status de uma transação mudar.

Depois de criar uma avaliação com dados de transação incluídos, a prevenção contra fraudes do reCAPTCHA retorna um veredito e um nome de avaliação. Faça anotações na avaliação com eventos de transação nas seguintes etapas importantes do ciclo de vida do pagamento quando elas ocorrerem:

Tipo de evento Descrição Exemplo de motivo Exemplo de valor
MERCHANT_APPROVE | MERCHANT_DENY Quando você decide se a transação tem permissão para continuar. IN_HOUSE N/A
AUTHORIZATION | AUTHORIZATION_DECLINE Ao enviar a transação a ser processada e o emissor do cartão decide se quer permitir que a transação prossiga. 82 (um código de motivo que significa que o CVV estava incorreto) N/A
CHARGEBACK Quando a transação é estornada. Card Reported Stolen 20 (representando um estorno parcial de 20 unidades monetárias)

Além do tipo de evento CHARGEBACK, inclua o código de motivo de estorno fornecido pelo emissor do cartão usando o campo reason. Além disso, inclua o valor monetário estornado no campo value se a transação foi parcialmente estornada.

No campo reason do evento de transação, inclua termos de esclarecimento para fornecer mais contexto sobre o motivo do evento ou forneça códigos de motivo que são recebidos diretamente da rede de pagamentos ou do emissor do cartão. Esses termos e códigos variam de acordo com o tipo de evento.

A tabela a seguir especifica a lista completa de tipos de evento de transação:

Motivo da anotação Descrição
MERCHANT_APPROVE Indica que a transação foi aprovada pelo comerciante. O os motivos podem incluir termos como IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MERCHANT_DENY Indica que a transação foi negada e concluída devido a riscos detectados pelo comerciante. As razões podem incluir termos como IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MANUAL_REVIEW Indica que a transação está sendo avaliada por um humano devido a suspeita ou risco.
AUTHORIZATION Indica que a tentativa de autorização com o emissor do cartão foi bem-sucedida.
AUTHORIZATION_DECLINE Indica que a tentativa de autorização com o emissor do cartão falhou. O os motivos podem incluir o 54 da Visa indicando que o cartão está expirado ou 82 indicando que o CSC está incorreto.
PAYMENT_CAPTURE Indica que a transação foi concluída porque os fundos foram se estabeleceu.
PAYMENT_CAPTURE_DECLINE Indica que não foi possível concluir a transação porque os fundos não foram resolvidos.
CANCEL Indica que a transação foi cancelada. Especifique o motivo o cancelamento. Por exemplo, INSUFFICIENT_INVENTORY
CHARGEBACK_INQUIRY Indica que o comerciante recebeu uma consulta de estorno devido a fraude na transação, solicitando informações adicionais antes que um estorno fraudulento seja oficialmente emitido e uma notificação formal de estorno seja enviada.
CHARGEBACK_ALERT Indica que o comerciante recebeu um alerta de estorno devido a fraude na transação. O processo de resolver a disputa sem que envolvem a rede de pagamentos é iniciada.
FRAUD_NOTIFICATION Indica que uma notificação de fraude foi emitida para a transação, enviada pelo banco emissor do instrumento de pagamento porque a transação parece ser fraudulenta. Recomendamos incluir dados de TC40 ou SAFE no reason para este tipo de evento. Para chargebacks parciais, recomendamos que você inclua um valor no campo value.
CHARGEBACK Indica que o comerciante foi informado pela rede de pagamentos que o transação entrou no processo de estorno devido a uma fraude. Código do motivo como 6005 e 6041 do Discover. Para estornos parciais, recomendamos incluir um valor no campo value.
CHARGEBACK_REPRESENTMENT Indica que a transação entrou no processo de estorno devido a fraude e que o comerciante escolheu fazer a representação. Exemplos de motivos incluem 6005 e 6041 do Discover. Para chargebacks parciais, recomendamos que você inclua um valor no campo value.
CHARGEBACK_REVERSE Indica que a transação teve um estorno por fraude que foi ilegítima e, como resultado, foi revertida. Para estornos parciais, recomendamos incluir um valor no campo value.
REFUND_REQUEST Indica que o comerciante recebeu um reembolso por um pedido transação. Para reembolsos parciais, recomendamos que você inclua um valor no campo value. Exemplo de motivo: FRAUD.
REFUND_DECLINE Indica que o comerciante recebeu uma solicitação de reembolso para esta transação, mas a recusou. Para reembolsos parciais, recomendamos incluir um valor no campo value. Exemplo de motivo: FRAUD.
REFUND Indica que a transação concluída foi reembolsada pelo comerciante. Para reembolsos parciais, recomendamos que você inclua um valor no campo value . Exemplo de motivo: PROACTIVE_FRAUD.
REFUND_REVERSE Indica que a transação concluída foi reembolsada pelo comerciante e que esse reembolso foi revertido. Para reembolsos parciais, recomendamos que você inclua um valor no campo value.

O exemplo a seguir mostra um payload de anotação de exemplo que contém um evento de transação. Para mais detalhes, consulte Como anotar avaliações.

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

A seguir