创建 IDV 会话

POST
/openapi/v1/customers/provider-kyc/rfis/{rfiId}/questions/{questionId}/idv-session

为待作答 RFI 中的 IDV 题创建身份核验会话。

  • RFI 不是 ACTION_REQUIRED 时返回 provider_kyc.rfi.not_actionable。题目不是本 RFI 的 IDV 题时返回 provider_kyc.rfi.question_not_idv。
  • url 是一次性会话链接。只交给完成核验的人员,不要记录或转发。
  • 核验完成后,仍要随整张 RFI 提交这道题。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

路径参数

rfiId*string

渠道分配的 RFI ID。

questionId*string

IDV 题的 ID。

查询参数

customerUid*string

调用方为客户定义的 UID,提交 KYB 时在渠道建档。

Header 参数

X-Channel-Provider*string

渠道提供商标识。渠道侧 KYC 当前只支持 LEGEND。

响应体

返回 IDV 会话。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?
请求示例
curl -X POST 'https://api.test.stabofx.com/openapi/v1/customers/provider-kyc/rfis/rfc_xxx/questions/rfq_idv/idv-session?customerUid=cust_example_001' \  -H 'X-Channel-Provider: LEGEND'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "trace-uuid-string",  "data": {    "url": "https://idv.example.com/session/xxx"  }}