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 possível, a prevenção contra fraudes do reCAPTCHA precisa saber os eventos do ciclo de vida de pagamentos das 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 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 envia 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 sistema quando os dados estiverem disponíveis, por exemplo, quando o status de uma transação muda.
Depois de criar uma avaliação com os dados da transação incluídos, a prevenção contra fraudes do reCAPTCHA retorna um veredito e um nome de avaliação. Anote a avaliação com eventos de transação nos seguintes estágios importantes do ciclo de vida de 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 quer 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 (que representa um estorno parcial de 20 unidades de moeda) |
Além do 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 monetário estornado no campo value
se a transação tiver sido
parcialmente estornada.
No campo reason
do evento da 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 de 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 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. 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 podem incluir o 54 da Visa, que indica que o cartão está
expirado, ou o 82 , que indica que o código de segurança do cartão (CSC) está incorreto.
|
PAYMENT_CAPTURE |
Indica que a transação foi concluída porque os fundos foram liquidados. |
PAYMENT_CAPTURE_DECLINE |
Indica que a transação não foi concluída 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 uma fraude na transação, solicitando mais informações antes que um estorno por fraude 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 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 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 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 incluir um valor no campo value .
|
CHARGEBACK_REPRESENTMENT |
Indica que a transação entrou no processo de estorno devido a uma
fraude e que o comerciante optou por inserir a representação. Exemplos de
motivos incluem 6005 e 6041 do Discover. Para estornos parciais, recomendamos incluir um valor no campo value .
|
CHARGEBACK_REVERSE |
Indica que a transação teve um estorno por fraude que era
ilegítimo e foi revertido como resultado. Para estornos parciais, recomendamos incluir um valor no campo value .
|
REFUND_REQUEST |
Indica que o comerciante recebeu um reembolso por uma transação concluída. Para reembolsos parciais, recomendamos incluir um valor
no campo value . Exemplo de motivo: FRAUD .
|
REFUND_DECLINE |
Indica que o comerciante recebeu uma solicitação de reembolso para essa 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 incluir 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
incluir um valor no campo value .
|
O exemplo a seguir mostra um payload de anotação de amostra que contém um evento de transação. Para saber mais, 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
- Saiba mais sobre os recursos de proteção de contas de usuário em Recursos de proteção de contas de usuário.