Anote as avaliações com eventos de transação

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

Para um melhor desempenho, a prevenção de fraudes do reCAPTCHA precisa de visibilidade dos eventos do ciclo de vida de pagamento das transações. Por isso, recomendamos que envie anotações para as avaliações que criou com dados de transações. Por exemplo, pode fornecer as informações da transação à prevenção contra fraudes do reCAPTCHA como um evento de transação nos seguintes cenários:

  • O fornecedor de pagamentos aceita ou recusa a transação.

  • O comerciante emite um reembolso.

  • O emissor do pagamento apresenta um reembolso.

Para saber como enviar anotações, consulte o artigo Anotar avaliações.

Recomendamos que faça estes pedidos automaticamente como parte da lógica correspondente no seu sistema quando os dados estiverem disponíveis, por exemplo, quando o estado de uma transação muda.

Depois de criar uma avaliação com dados de transações incluídos, o reCAPTCHA Fraud Prevention devolve um veredicto e um nome da avaliação. Anotar a avaliação com eventos de transação nas seguintes fases importantes do ciclo de vida do pagamento quando ocorrem:

Tipo de evento Descrição Exemplo de motivo Exemplo de valor
MERCHANT_APPROVE | MERCHANT_DENY Quando decide se a transação deve ser permitida. IN_HOUSE N/A
AUTHORIZATION | AUTHORIZATION_DECLINE Quando envia a transação para processamento, o emissor do cartão decide se permite que a transação avance. 82 (um código de motivo que significa que o CVV estava incorreto) N/A
CHARGEBACK Quando a transação é anulada. Card Reported Stolen 20 (que representa um estorno parcial de 20 unidades da moeda)

Juntamente com o tipo de evento CHARGEBACK, inclua o código do motivo da contestação que foi fornecido pelo emissor do cartão através do campo reason. Além disso, inclua o valor monetário anulado no campo value se a transação tiver sido parcialmente anulada.

No campo reason do evento de transação, inclua termos esclarecedores para fornecer mais contexto sobre o motivo do evento ou indique códigos de motivos obtidos diretamente da rede de pagamentos ou do emissor do cartão. Estes termos e códigos diferem consoante o tipo de evento.

A tabela seguinte especifica a lista completa de tipos de eventos de transação:

Motivo da anotação Descrição
MERCHANT_APPROVE Indica que a transação foi aprovada pelo comerciante. Os motivos associados podem incluir termos como IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MERCHANT_DENY Indica que a transação foi recusada e concluída devido a riscos detetados pelo comerciante. Os motivos associados podem incluir termos como IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MANUAL_REVIEW Indica que a transação está a ser avaliada por um humano devido a suspeita ou risco.
AUTHORIZATION Indica que a tentativa de autorização junto do emissor do cartão foi bem-sucedida.
AUTHORIZATION_DECLINE Indica que a tentativa de autorização com o emissor do cartão falhou. Os motivos associados podem incluir o código 54 da Visa, que indica que o cartão está expirado, ou o código 82, que indica que o CVV está incorreto.
PAYMENT_CAPTURE Indica que a transação foi concluída porque os fundos foram liquidados.
PAYMENT_CAPTURE_DECLINE Indica que não foi possível concluir a transação porque os fundos não foram liquidados.
CANCEL Indica que a transação foi cancelada. Especifique o motivo do cancelamento. Por exemplo, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Indica que o comerciante recebeu uma consulta de estorno devido a fraude para a transação, solicitando informações adicionais antes de ser emitido oficialmente um estorno por fraude e de ser enviada uma notificação formal de estorno.
CHARGEBACK_ALERT Indica que o comerciante recebeu um alerta de estorno devido a fraude para a transação. O processo de resolução do diferendo sem envolver a rede de pagamento é iniciado.
FRAUD_NOTIFICATION Indica que é emitida uma notificação de fraude para a transação, enviada pelo banco emissor do meio de pagamento, porque a transação parece ser fraudulenta. Recomendamos que inclua dados de TC40 ou SAFE no campo reason para este tipo de evento. Para estornos parciais, recomendamos que inclua um valor no campo value.
CHARGEBACK Indica que o comerciante é informado pela rede de pagamentos de que a transação entrou no processo de estorno devido a fraude. Os exemplos de código do motivo incluem 6005 e 6041 do Discover. Para estornos parciais, recomendamos que inclua um valor no campo value.
CHARGEBACK_REPRESENTMENT Indica que a transação entrou no processo de contestação devido a fraude e que o comerciante optou por apresentar uma nova representação. Os exemplos de motivos incluem 6005 e 6041 do Discover. Para estornos parciais, recomendamos que inclua um valor no campo value.
CHARGEBACK_REVERSE Indica que a transação teve um estorno fraudulento que era ilegítimo e foi revertido como resultado. Para estornos parciais, recomendamos que inclua um valor no campo value.
REFUND_REQUEST Indica que o comerciante recebeu um reembolso por uma transação concluída. Para reembolsos parciais, recomendamos que inclua um valor no campo value. Exemplo de motivo: FRAUD.
REFUND_DECLINE Indica que o comerciante recebeu um pedido de reembolso para esta transação, mas que o recusou. Para reembolsos parciais, recomendamos que inclua 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 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 este reembolso foi revertido. Para reembolsos parciais, recomendamos que inclua um valor no campo value.

O exemplo seguinte mostra um payload de anotação de amostra que contém um evento de transação. Para mais detalhes, consulte o artigo Anotar avaliações.

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

O que se segue?