- 欢迎接入珊瑚开放平台
- 接入指 南
- 进件
- 存款
- 付款
- 发行
- 辅助工具
- 多币种钱包
- 换汇
- 事件订阅
- 附录
提交进件(快照)
POST
/v1/kyc/apply
最后修改时间:2025-05-07 03:35:23
请求参数
Header 参数
X-Request-Id
string
请求标识
默认值:
{{X-Request-Id}}
Body 参数application/json
` * @description 数据模型
user
object (KycApplyUserDTO)
用户信息
email
string
邮箱
mobile
string
手机号码
partnerSerialNumber
string
可选
detail
object (KycApplyDetailDTO)
认证详情
entity
enum<string>
信息类型
枚举值:
INDIVIDUALENTERPRISE_CNENTERPRISE_HK
enterprise
object (KycApplyEnterpriseDTO)
企业信息
individual
object (KycApplyIndividualDTO)
个人信息
示例
{
"user": {
"email": "string",
"mobile": "string",
"partnerSerialNumber": "string"
},
"detail": {
"entity": "INDIVIDUAL",
"enterprise": {
"beneficiary": [
{
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string",
"equityRatio": 0
}
],
"legal": {
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string"
},
"director": [
{
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string"
}
],
"agent": {
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string",
"certHandheld": "string",
"certVideo": "string",
"letterOfAuthorization": "string"
},
"businessAddress": "string",
"companyAddress": "string",
"companyCnName": "string",
"companyEnName": "string",
"licenseImage": "string",
"licenseNo": "string",
"licenseStartTime": "string",
"licenseEndTime": "string",
"recordImage": "string",
"recordNo": "string",
"recordStartTime": "string",
"recordEndTime": "string",
"region": "string",
"category": "CLOTHING"
},
"individual": {
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string",
"certHandheld": "string",
"certVideo": "string",
"category": "CLOTHING"
}
}
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://gateway-openapi.coralglobal.cn/v1/kyc/apply' \
--header 'X-Request-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"user": {
"email": "string",
"mobile": "string",
"partnerSerialNumber": "string"
},
"detail": {
"entity": "INDIVIDUAL",
"enterprise": {
"beneficiary": [
{
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string",
"equityRatio": 0
}
],
"legal": {
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string"
},
"director": [
{
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string"
}
],
"agent": {
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string",
"certHandheld": "string",
"certVideo": "string",
"letterOfAuthorization": "string"
},
"businessAddress": "string",
"companyAddress": "string",
"companyCnName": "string",
"companyEnName": "string",
"licenseImage": "string",
"licenseNo": "string",
"licenseStartTime": "string",
"licenseEndTime": "string",
"recordImage": "string",
"recordNo": "string",
"recordStartTime": "string",
"recordEndTime": "string",
"region": "string",
"category": "CLOTHING"
},
"individual": {
"cert": "ID_CARD",
"certNo": "string",
"certName": "string",
"certAddress": "string",
"certFrontPic": "string",
"certBackPic": "string",
"certStartTime": "string",
"certEndTime": "string",
"permanentAddress": "string",
"region": "string",
"certHandheld": "string",
"certVideo": "string",
"category": "CLOTHING"
}
}
}'
返回响应
🟢200成功
application/json
Body
code
string
错误编码
message
string
错误信息
data
object (KycApplyVO)
响应主体
userId
string
用户标识
partnerSerialNumber
string
可选
timestamp
string
时间戳