curl --request POST \
  --url https://api.qbank.cl/platform/v1/aml/screenings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "person": {
      "full_name": "Ana Perez Rojas",
      "date_of_birth": {
        "year": 1990,
        "month": 4,
        "day": 12
      },
      "personal_identification": [
        {
          "issuing_country": "CL",
          "number": "12.345.678-5"
        }
      ]
    },
    "email": "ana@example.com",
    "country": "CL"
  },
  "monitor": false
}
'

{
  "screening_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "kind": "screening",
  "service": "compliance_person",
  "subject_type": "person",
  "subject_name": "Ana Perez Rojas",
  "risk": "low",
  "monitor": false,
  "screening_fee": "2.000000",
  "fee_asset": "USDT",
  "idempotency_key": "aml-screen-ana-1",
  "created_at": "2026-07-12T18:00:00Z",
  "result": {
    "customer_id": "e1d2c3b4-a596-8778-695a-4b3c2d1e0f9a",
    "status": "completed",
    "risk_level": "low",
    "screening_result": "no_hits",
    "monitored": false
  }
}

{
  "error": "idempotency_key_required",
  "message": "provide idempotency_key (body or Idempotency-Key header)"
}

{
  "error": "unauthorized",
  "message": "invalid or missing credentials"
}

{
  "error": "insufficient_funds",
  "message": "account balance is not enough for this operation"
}

{
  "error": "account_required",
  "message": "this endpoint requires an account credential"
}

{
  "error": "compliance_unavailable",
  "message": "screening temporarily unavailable"
}

Enviar un screening AML

Screenea una persona o empresa (detectado desde el payload) contra listas de sanciones, PEP y prensa adversa vía el servicio de compliance. Es solo screening de listas — la verificación de identidad con documentos y prueba de vida vive en /v1/kyc y /v1/kyb. Todos los campos de identidad son opcionales y se reenvían íntegros al motor; mientras más datos envíes, más preciso es el análisis. Si hay comisión de compliance, se debita antes de la llamada y se reembolsa si falla. El resultado queda guardado localmente para historial (GET /v1/aml/screenings). idempotency_key es obligatoria — repetir con la misma clave devuelve el screening original con idempotency_hit true sin cobrar dos veces.

POST

aml

screenings

curl --request POST \
  --url https://api.qbank.cl/platform/v1/aml/screenings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "person": {
      "full_name": "Ana Perez Rojas",
      "date_of_birth": {
        "year": 1990,
        "month": 4,
        "day": 12
      },
      "personal_identification": [
        {
          "issuing_country": "CL",
          "number": "12.345.678-5"
        }
      ]
    },
    "email": "ana@example.com",
    "country": "CL"
  },
  "monitor": false
}
'

{
  "screening_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "kind": "screening",
  "service": "compliance_person",
  "subject_type": "person",
  "subject_name": "Ana Perez Rojas",
  "risk": "low",
  "monitor": false,
  "screening_fee": "2.000000",
  "fee_asset": "USDT",
  "idempotency_key": "aml-screen-ana-1",
  "created_at": "2026-07-12T18:00:00Z",
  "result": {
    "customer_id": "e1d2c3b4-a596-8778-695a-4b3c2d1e0f9a",
    "status": "completed",
    "risk_level": "low",
    "screening_result": "no_hits",
    "monitored": false
  }
}

{
  "error": "idempotency_key_required",
  "message": "provide idempotency_key (body or Idempotency-Key header)"
}

{
  "error": "unauthorized",
  "message": "invalid or missing credentials"
}

{
  "error": "insufficient_funds",
  "message": "account balance is not enough for this operation"
}

{
  "error": "account_required",
  "message": "this endpoint requires an account credential"
}

{
  "error": "compliance_unavailable",
  "message": "screening temporarily unavailable"
}

Autorizaciones

Authorization

string

header

requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json

idempotency_key

string

requerido

Obligatoria (el screening cobra comisión). También aceptada en el header Idempotency-Key.

customer

object

Identity data. Provide person or company; when omitted it is filled from the account profile. Additional fields are accepted and forwarded to the screening engine.

Show child attributes

monitor

boolean

predeterminado:false

Enable continuous monitoring from the start.

Respuesta

Screening enviado y guardado localmente.

Espejo local del screening más campos de cobro. El resultado completo está en result.

screening_id

string

kind

enum<string>

Opciones disponibles:

screening

service

enum<string>

Opciones disponibles:

compliance_person,

compliance_company

subject_type

enum<string>

Opciones disponibles:

person,

company

subject_name

string

risk

string

monitor

boolean

screening_fee

string

fee_asset

string

idempotency_key

string

idempotency_hit

boolean

created_at

string<date-time>

result

object

Resultado neutro del servicio de compliance.