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

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

Para ter o melhor desempenho, a prevenção contra fraudes do reCAPTCHA precisa de visibilidade dos eventos do ciclo de vida de pagamentos para transações. Portanto, recomendamos que você envie anotações para as avaliações criadas com dados de transações. Por exemplo, é possível fornecer as informações de 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 essas solicitações sejam feitas automaticamente como parte da lógica correspondente no sistema quando os dados estiverem disponíveis, por exemplo, quando o status de uma transação mudar.

Depois de criar uma avaliação com os dados de transação incluídos, a prevenção contra fraudes do reCAPTCHA retorna um veredito e um nome da avaliação. Anote a avaliação com eventos de transação nos seguintes estágios importantes do ciclo de vida do pagamento, quando eles 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 Quando você envia a transação que será processada, e o emissor do cartão decide se vai permitir que ela prossiga. 82 (um código de motivo indicando que o código de segurança do cartão estava incorreto) N/A
CHARGEBACK Quando a transação é estornada. Card Reported Stolen 20 (representando um estorno parcial de 20 unidades de moeda)

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

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

A tabela a seguir especifica a lista completa dos tipos de evento 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 negada e concluída devido aos riscos detectados pelo comerciante. Os motivos associados podem incluir termos como IN_HOUSE, ACCERTIFY, CYBERSOURCE ou MANUAL_REVIEW.
MANUAL_REVIEW Indica que a transação está sendo avaliada por um ser 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. Os motivos associados podem incluir o 54 da Visa indicando que o cartão expirou ou 82 indicando que o código de segurança do cartão 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 por causa de fraude na transação e pede mais informações antes da emissão oficial de um estorno por fraude e do envio de uma notificação formal de estorno.
CHARGEBACK_ALERT Indica que o comerciante recebeu um alerta de estorno devido a uma fraude na transação. O processo de resolução da disputa sem envolver a rede de pagamentos é iniciado.
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 campo reason para esse tipo de evento. Para estornos parciais, recomendamos que você inclua um valor no campo value.
CHARGEBACK Indica que o comerciante foi informado pela rede de pagamentos de que a transação entrou no processo de estorno devido a uma fraude. Os exemplos de código de motivo incluem 6005 e 6041 do Discover. Para estornos parciais, recomendamos que você inclua um valor no campo value.
CHARGEBACK_REPRESENTMENT Indica que a transação entrou no processo de estorno devido a fraude e que o comerciante optou por participar da representação. Os exemplos de motivos incluem 6005 e 6041 do Discover. Para estornos parciais, recomendamos que você inclua um valor no campo value.
CHARGEBACK_REVERSE Indica que a transação teve um estorno por fraude ilegítimo e, por isso, foi revertido. Para estornos parciais, recomendamos que você 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 você inclua um valor no campo value. Exemplo de motivo: FRAUD.
REFUND_DECLINE Indica que o comerciante recebeu uma solicitação de reembolso para a transação, mas que a recusou. Para reembolsos parciais, recomendamos que você 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 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 esse reembolso foi revertido. Para reembolsos parciais, recomendamos que você inclua um valor no campo value.

No exemplo a seguir, mostramos um exemplo de payload de anotação que contém um evento de transação. Para mais detalhes, consulte 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