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Í |
#
EjemplosAbajo, se muestra un ejemplo de cómo llamar al servicio de marcado de fraudes mediante la herramienta cURL.
Solicitud:
Respuesta:
#
Parámetros de solicitudHasta ahora, no hay parámetros para enviar en el cuerpo de la solicitud.
#
Parámetros de respuestaSi 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 |