Servicio de marcado de fraudes

Después de una transacción antifraude exitosa (pago con Status CON, PPC, PPN o EST), la tienda puede identificar que en realidad fue un fraude. En este caso, la tienda puede hacer una llamada al servicio de señalización de fraudes para notificar a la institución de análisis de riesgos este hecho. Esto refinará el proceso de revisión de esa institución, haciéndolo más preciso y previniendo más fraudes en el futuro.

Actualmente, esta API es compatible con las siguientes instituciones antifraude:

• Konduto
• Antifraude Fiserv
• ClearSale REST

Detalles de la llamada

• Recurso: /v1/transactions/{nit}/fraud
• Método HTTP: POST
• Formato de solicitud: JSON
• Formato de respuesta: JSON
• Parámetros de encabezado:

Parámetro	Descripción	Formato	Obligatorio
merchant_id	Código de la tienda en Portal Carat. Los códigos de producción y certificación serán diferentes.	< 15 AN	SÍ
merchant_key	Clave de autenticación de la tienda en Portal Carat. Las claves de producción y de certificación serán diferentes.	80 AN	SÍ
Content-Type	Debe enviarse con el valor application/json.	= 15 AN	SÍ

Ejemplos

Abajo, se muestra un ejemplo de cómo llamar al servicio de marcado de fraudes mediante la herramienta cURL.

Solicitud:

curl

--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/transactions/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr/fraud"

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

--header "merchant_id: xxxxxxxx"

--header "merchant_key: xxxxxxxxxxx"

--data-binary

{}

--verbose

Respuesta:

{

"code": "0",

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

"analysis": {

"code": "0",

"message": "Sucesso"

}

}

Parámetros de solicitud

Hasta ahora, no hay parámetros para enviar en el cuerpo de la solicitud.

Parámetros de respuesta

Si tiene éxito, el código de respuesta HTTP será "201". Cualquier otro código debe interpretarse como un error. En la siguiente tabla se muestra una descripción de los parámetros de respuesta del servicio de marcado de fraude:

| Parámetro | Descripción | Formato |

| --------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------- | | code | Código de respuesta Portal Carat. Cualquier código que no sea "0" significa error. [Sepa mas.]

(codigos-da-api.md#códigos-de-resposta) | < 4 N |

| message | Mensaje de respuesta de e SiTef.
| < 500 AN | | | analysis | | | code | Código de respuesta de la institución de análisis de riesgos. | < 4 N
| | message | Mensaje de respuesta de la institución de análisis de riesgos. | < 500 AN |