Enviar feedback de una transacción

POST

/feedback/{transaction_id}

curl --request POST \
  --url https://report.lbfraud.ironchip.com/feedback/example \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "behaviour": { "desired": { "fraud_cases": [ "device swapping", "location swapping" ], "risk_assignment": "clear" } }, "impact": { "description": "The transaction has been detected as fraud rather than low" }, "reporter": { "email": "analista@banco.example", "name": "Nombre", "surname": "Apellido" }, "situation": { "description": "The customer has downloaded the app to an unknown device located in a new country" }, "valuation": { "annotations": "It is not possible to tell a real client from a fake one without client confirmation", "score": 8, "type": "Corrective" } }'

• Producción

Registra la valoración del cliente sobre el informe de una transacción: qué resultado se esperaba, qué impacto tuvo y quién lo reporta. Ironchip usa este feedback para ajustar el motor de detección.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

transaction_id

required

string

Identificador de la transacción a la que se refiere el feedback.

Request Body^required

Media typeapplication/json

object

behaviour

required

object

desired

required

Resultado que el cliente esperaba del motor.

object

risk_assignment

required

Nivel de riesgo esperado.

string

Allowed values: fraud high low clear

fraud_cases

Casos de fraude que deberían (o no) haberse detectado.

Array<string>

impact

object

description

Impacto que tuvo el resultado en el negocio.

string

<= 100 characters

reporter

Persona que envía el feedback.

object

name

string

<= 50 characters

surname

string

<= 50 characters

email

string format: email

<= 50 characters

situation

object

description

Contexto de la operación cuando se evaluó.

string

<= 100 characters

valuation

object

type

Tipo de valoración.

string

Allowed values: Positive Negative Corrective

score

Puntuación de 0 a 10.

integer

<= 10

annotations

Anotaciones libres.

string

<= 100 characters

Example

{
  "behaviour": {
    "desired": {
      "fraud_cases": [
        "device swapping",
        "location swapping"
      ],
      "risk_assignment": "clear"
    }
  },
  "impact": {
    "description": "The transaction has been detected as fraud rather than low"
  },
  "reporter": {
    "email": "analista@banco.example",
    "name": "Nombre",
    "surname": "Apellido"
  },
  "situation": {
    "description": "The customer has downloaded the app to an unknown device located in a new country"
  },
  "valuation": {
    "annotations": "It is not possible to tell a real client from a fake one without client confirmation",
    "score": 8,
    "type": "Corrective"
  }
}

Responses

200

Feedback registrado.

400

Algún parámetro no es válido (por ejemplo, limit mayor que 100 o un timeout o since con formato incorrecto) o el cuerpo del feedback no es un JSON válido.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}

401

La clave de API falta o no es válida.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}

404

No hay informes para la aplicación o la transacción indicada.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}

500

Error interno del servidor.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}