查询 RFI 详情

GET
/openapi/v1/customers/provider-kyc/rfis/{rfiId}

查询一张 RFI 及其题目。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

路径参数

rfiId*string

渠道分配的 RFI ID。

查询参数

customerUid*string

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

Header 参数

X-Channel-Provider*string

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

响应体

返回 RFI 详情。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?

渠道发起的补件请求(RFI)。

请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/customers/provider-kyc/rfis/rfc_xxx?customerUid=cust_example_001' \  -H 'X-Channel-Provider: LEGEND'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "trace-uuid-string",  "data": {    "rfiId": "rfc_xxx",    "customerUid": "cust_example_001",    "status": "ACTION_REQUIRED",    "restrictions": [      "swap",      "fiat_withdrawal"    ],    "expiresAt": "2026-11-20T00:00:00+08:00",    "updatedAt": "2026-11-10T10:00:00+08:00",    "questions": [      {        "questionId": "rfq_text",        "replyType": "TEXT",        "questionText": "Describe the main business of the company.",        "required": true,        "maxLength": 500      },      {        "questionId": "rfq_doc",        "replyType": "DOC",        "questionText": "Upload the latest bank statement.",        "required": true,        "fileRequired": true,        "maxFiles": 3      },      {        "questionId": "rfq_text_doc",        "replyType": "TEXT_DOC",        "questionText": "Explain the source of the last large deposit and upload proof.",        "required": true,        "fileRequired": true,        "maxLength": 500,        "maxFiles": 2      },      {        "questionId": "rfq_checkbox",        "replyType": "CHECKBOX",        "questionText": "Select the expected payment purposes.",        "options": [          "Supplier payments",          "Payroll",          "Others"        ],        "required": true      },      {        "questionId": "rfq_idv",        "replyType": "IDV",        "questionText": "Complete identity verification for the director.",        "required": true,        "idvStarted": false      }    ]  }}