开发者文档
官网控制台

查询 KYC 提交要求

GET
/openapi/v1/customers/provider-kyc/requirements

返回向渠道提交企业 KYC（KYB）所需的国家、选项和文件要求。

  • label 按请求语言返回，只用于展示。提交时用 code。
  • 不传 customerUid 时，options 有 8 个键。
  • options["documents[].category"] 是文件分类的参考值，不是完整列表。其他值原样转给渠道，由渠道判定。
  • 带 customerUid 时，已在渠道建档的客户额外返回 questionnaire.purposes。新客户返回的结果不含 questionnaire.purposes。
  • 新客户首次提交时，questionnaire.purposes 可以填参考值 invest_trade、crypto_fiat。这不是完整列表，取值由渠道校验。
  • 首次调用约 10 秒，之后命中缓存会更快。客户端超时建议不低于 60 秒。

完整流程见 渠道 KYC 与开户。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

查询参数

customerUid?string

调用方为客户定义的 UID。客户已在渠道建档时，结果额外含 questionnaire.purposes。新客户的结果不含。

Header 参数

X-Channel-Provider*string

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

响应体

返回表单字典。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?

提交 KYB 的表单字典。

请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/customers/provider-kyc/requirements' \  -H 'X-Channel-Provider: LEGEND'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "trace-uuid-string",  "data": {    "countries": [      {        "code": "SG",        "label": "Singapore"      },      {        "code": "HK",        "label": "Hong Kong"      }    ],    "options": {      "questionnaire.currency": [        {          "code": "USD",          "label": "USD"        }      ],      "documents[].category": [        {          "code": "utility_bill",          "label": "Utility bill"        }      ],      "questionnaire.purposes": [        {          "code": "invest_trade",          "label": "<label>"        },        {          "code": "crypto_fiat",          "label": "<label>"        }      ]    },    "documents": [      {        "type": "INCORPORATION",        "owner": "COMPANY",        "required": true,        "categoryRequired": false      },      {        "type": "BUSINESS_ADDRESS",        "owner": "COMPANY",        "required": true,        "categoryRequired": true      },      {        "type": "AML_POLICY",        "owner": "COMPANY",        "required": false,        "requiredWhen": "business.regulatedFinancialInstitution=true",        "categoryRequired": false      }    ],    "fileConstraints": {      "maxBytes": 2097152,      "allowedContentTypes": [        "application/pdf",        "image/jpeg",        "image/png"      ]    }  }}