创建 IDV 会话
POST
为待作答 RFI 中的 IDV 题创建身份核验会话。
- RFI 不是
ACTION_REQUIRED时返回provider_kyc.rfi.not_actionable。题目不是本 RFI 的 IDV 题时返回provider_kyc.rfi.question_not_idv。 url是一次性会话链接。只交给完成核验的人员,不要记录或转发。- 核验完成后,仍要随整张 RFI 提交这道题。
bearerAuthheader
鉴权Bearer <令牌>通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。
rfiId*string渠道分配的 RFI ID。
questionId*stringIDV 题的 ID。
customerUid*string调用方为客户定义的 UID,提交 KYB 时在渠道建档。
X-Channel-Provider*string渠道提供商标识。渠道侧 KYC 当前只支持 LEGEND。
返回 IDV 会话。
application/json- response
code?integer业务状态码
message?stringtraceId?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" }}