Serviço de marcação de fraude

Após uma transação com antifraude bem sucedida (pagamento com status CON, PPC, PPN ou EST), a loja pode vir a identificar que, na realidade, tratava-se de uma fraude. Nesse caso, a loja pode realizar uma chamada ao serviço de marcação de fraude para avisar a instituição de análise de risco sobre essa ocorrência. Isso irá refinar o processo de análise dessa instituição, tornando-o mais preciso e evitando mais fraudes futuramente.

Atualmente, esta API suporta as seguintes instituições de antifraude:

• Konduto
• Fraud Detect
• ClearSale REST
• CyberSource

Detalhes da chamada

• Recurso: /v1/transactions/{nit}/fraud
• Método HTTP: POST
• Formato da requisição: JSON
• Formato da resposta: JSON
• Parâmetros de cabeçalho:

Parâmetro	Descrição	Formato	Obrigatório
merchant_id	Código da loja no Carat. Os códigos de produção e certificação serão diferentes.	< 15 AN	SIM
merchant_key	Chave de autenticação da loja no Carat. As chaves de produção e certificação serão diferentes.	< 80 AN	SIM
Content-Type	Deve ser enviado com o valor application/json.	= 15 AN	SIM

Exemplos

Abaixo está um exemplo de chamada do serviço de marcação de fraude utilizando a ferramenta cURL.

Requisição:

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor
esitef-homologacao.softwareexpress.com.br

curl

--request POST 'https://{{url}}/e-sitef/api/v1/transactions/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr/fraud'

--header 'Content-Type: application/json'

--header 'merchant_id: xxxxxxxx'

--header 'merchant_key: xxxxxxxxxxx'

--data '{

"marked_data": [

"account_key_hash",

"customer_account_id",

"customer_email"

]

}'

--verbose

Resposta:

{

"code": "0",

"message": "OK. Transaction successful.",

"analysis": {

"code": "100",

"message": "ACCEPT"

}

}

Parâmetros de requisição

Parâmetro	Descrição	Obrigatório
marked_data	Informa quais campos serão relevantes para informar a CyberSource que esta transação foi uma tentativa de fraude. Este campo recebe uma lista de valores. Ex: "marked_data":["account_key_hash","customer_account_id","customer_email"] Campos que podem ser informados: account_key_hash customer_account_id customer_email customer_idaddress customer_phone device_fingerprint ship_address	NÃO

Parâmetros de resposta

Em caso de sucesso, o código de resposta HTTP será 201. Qualquer outro código deve ser interpretado como erro. Na tabela abaixo está a descrição dos parâmetros de resposta do serviço de marcação de fraude:

Parâmetro	Descrição	Formato
code	Código de resposta do Carat. Qualquer código diferente de 0 significa falha. Saiba mais.	< 4 N
message	Mensagem de resposta do Carat.	< 500 AN
	analysis
code	Código de resposta da instituição de análise de risco.	< 4 N
message	Mensagem de resposta da instituição de análise de risco.	< 500 AN