{
  "consent_id": "c1a2b3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "subject_id": "7e8f9a0b-1c2d-4e3f-8a9b-0c1d2e3f4a5b",
  "country": "CL",
  "doc_id": "12.345.678-5",
  "subject_type": "person",
  "purpose": "credit_evaluation",
  "status": "granted",
  "previous_status": "pending",
  "holder_name": "Maria Jose Contreras Soto",
  "openfinance_link_id": "lnk_9b2c4d6e8f",
  "granted_at": "2026-08-10T09:21:44Z"
}

持有人已授予 qscore 授权

通过 POST /v1/qscore/consents 创建的授权链接已被授予：持有人打开了公开页面，通过开放金融连接其银行并授权了该请求（其核验证件与主体证件一致）。该授权现在会在新的 Qscore 报告中解锁主体的正向银行数据。previous_status 实际为 pending；携带它便于对账重放。

每次投递均包含 X-Webhook-Event、X-Webhook-Event-ID、X-Webhook-Delivery-ID、X-Webhook-Timestamp 和 X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body))。请返回 2xx；最多 5 次尝试，递增量退避。

WEBHOOK

risk_consent_granted

{
  "consent_id": "c1a2b3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "subject_id": "7e8f9a0b-1c2d-4e3f-8a9b-0c1d2e3f4a5b",
  "country": "CL",
  "doc_id": "12.345.678-5",
  "subject_type": "person",
  "purpose": "credit_evaluation",
  "status": "granted",
  "previous_status": "pending",
  "holder_name": "Maria Jose Contreras Soto",
  "openfinance_link_id": "lnk_9b2c4d6e8f",
  "granted_at": "2026-08-10T09:21:44Z"
}

授权

Authorization

string

header

必填

会话 JWT(来自注册/登录)或 API key(pk_...)。也接受 X-API-Key: <token> 作为替代请求头。

请求体

application/json

subject_id

string

country

string

doc_id

string

subject_type

enum<string>

可用选项:

person,

company

purpose

enum<string>

可用选项:

credit_evaluation,

tenant_screening,

hiring,

supplier_onboarding,

other

status

enum<string>

可用选项:

granted

previous_status

string

holder_name

string

openfinance_link_id

string

granted_at

string<date-time>

响应

200

返回任意 2xx 确认投递。