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"
}提交 AML 筛查
通过合规服务对个人或企业(由 payload 判定)进行制裁、PEP 与负面媒体名单筛查。仅名单筛查——带证件与活体核验的身份验证见 /v1/kyc 与 /v1/kyb。身份字段均为可选并完整转发;信息越完整结果越精确。若配置合规费用,调用前扣款,失败则退款。结果本地保存供审计(GET /v1/aml/screenings)。必须提供 idempotency_key——相同键重放返回原记录且 idempotency_hit true,不会重复扣费。
POST
/
v1
/
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"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
application/json
必填(筛查收费)。也可使用 Idempotency-Key 请求头。
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
Show child attributes
Enable continuous monitoring from the start.
响应
筛查已提交并本地保存。
筛查本地镜像及计费字段,完整结果在 result 中。
可用选项:
screening 可用选项:
compliance_person, compliance_company 可用选项:
person, company 合规服务返回的中立筛查结果。