商户个性化表单
获取表单配置
获取表单配置
端点目标 URL
沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/Onboarding/linkMerchantApi/getMerchantConfig
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
subMerchantId | M | string | 子商户id |
响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
configKey | String | 配置表单key |
valueFramework | String | 新增或修改数据需要的数据结构 |
configs | String | 数据结构中字段的定义与部分限制条件 |
configs.field | String | 数据结构中key的路径 |
configs.fieldLabel | String | 数据结构中字段的描述 |
configs.required | String | 是否必填(1:必填，0：非必填) |
configs.dictKey | String | 字典key(该值不为空时表示该字段仅允许字典数据)获取字典数据 |
configs.min | String | 最小值(该值不为空时表示该字段的值或数据条数需大于最小值) |
configs.max | String | 最大值(该值不为空时表示该字段的值或数据条数需小于最大值) |
configs.minDate | String | 最小时间(该值不为空时表示该字段需要传入的时间不能小于该值) |
configs.maxDate | String | 最大时间(该值不为空时表示该字段需要传入的时间不能大于该值) |
configs.dateFormat | String | 时间格式 |
集成
获取表单配置调用输入
{
"subMerchantId": "1988939494086324224"
}获取表单配置调用输出
{
"code": "0",
"msg": "success",
"serverTime": "1765874389926",
"data": [
{
"configKey": "KYC_MERCHANT_BASIC",
"valueFramework": {
"transactionsNumber": "",
"businessWebsiteList": [
{
"webSite": null
}
],
"funding": [],
"averageCollectionAmount": "",
"Materials": [],
"applyProductList": [],
"businessCountryList": [],
"EmploymentStatus": "",
"openingPurpose": "",
"tradingVolume": "",
"averagePaymentAmount": ""
},
"configs": [
{
"field": "applyProductList",
"fieldLabel": null,
"required": "1",
"dictKey": "applyProductList",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "tradingVolume",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "transactionsNumber",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "averagePaymentAmount",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "averageCollectionAmount",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "businessWebsiteList",
"fieldLabel": null,
"required": "0",
"dictKey": null,
"min": "0",
"max": "9999",
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "businessWebsiteList.webSite",
"fieldLabel": null,
"required": "0",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "businessCountryList",
"fieldLabel": null,
"required": "1",
"dictKey": "kyc_country",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "openingPurpose",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "funding",
"fieldLabel": null,
"required": "1",
"dictKey": "funding",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "Materials",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": "1",
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "EmploymentStatus",
"fieldLabel": null,
"required": "1",
"dictKey": "Employment_Status",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
}
]
},
{
"configKey": "KYC_MERCHANT_PAYER",
"valueFramework": {
"list": [
{
"country": null,
"name": null,
"tradingVolume": null
}
]
},
"configs": [
{
"field": "list",
"fieldLabel": null,
"required": "0",
"dictKey": null,
"min": "0",
"max": "50",
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.name",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.country",
"fieldLabel": null,
"required": "1",
"dictKey": "country",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.tradingVolume.amount",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.tradingVolume.currency",
"fieldLabel": null,
"required": "1",
"dictKey": "currency",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
}
]
},
{
"configKey": "KYC_MERCHANT_BENEFICIARY",
"valueFramework": {
"list": [
{
"country": null,
"name": null,
"tradingVolume": null
}
]
},
"configs": [
{
"field": "list",
"fieldLabel": null,
"required": "0",
"dictKey": null,
"min": "3",
"max": "9999",
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.name",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.country",
"fieldLabel": null,
"required": "1",
"dictKey": "country",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.tradingVolume.amount",
"fieldLabel": null,
"required": "1",
"dictKey": null,
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
},
{
"field": "list.tradingVolume.currency",
"fieldLabel": null,
"required": "1",
"dictKey": "currency",
"min": null,
"max": null,
"minDate": null,
"maxDate": null,
"dateFormat": null
}
]
}
],
"success": true
}填写个性化表单
填写个性化表单
端点目标 URL
字段说明
调用的特定输入参数
响应data参数
同获取数据子商户详情接口一致
集成
填写个性化表单调用输入
{
"subMerchantId": "1988939494086324224",
"dataList": [
{
"configKey": "KYC_MERCHANT_BASIC",
"status": "Submitted",
"data": {
"transactionsNumber": "100",
"businessWebsiteList": [],
"funding": [
"salary_income",
"e_commerce_Platform",
"Advertising_Platform",
"Acquirer_Tool",
"Developer_Platform"
],
"averageCollectionAmount": "1000",
"Materials": [
"baseInfo/1929803377366183936/kycAPI/abe944b2e61f4f958cd0560d478406f0.png"
],
"applyProductList": [
"GLOBAL_RECEIVABLES"
],
"businessCountryList": [
"CN"
],
"EmploymentStatus": "Student",
"openingPurpose": "1111开户",
"tradingVolume": "1000",
"averagePaymentAmount": "1000"
}
},
{
"configKey": "KYC_MERCHANT_PAYER",
"status": "Submitted",
"data": {
"list": [
{
"country": "US",
"name": "名称11",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称22",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称32",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
}
]
}
},
{
"configKey": "KYC_MERCHANT_BENEFICIARY",
"status": "Submitted",
"data": {
"list": [
{
"country": "US",
"name": "名称11",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称22",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称32",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
}
]
}
}
]
}填写个性化表单调用输出
{
"code": "0",
"msg": "success",
"serverTime": "1765857261570",
"data": {
"subMerchantId": "1988939494086324224",
"requestID": "5aef9014-0875-488a-85bb-448e1cd0b270",
"merchantName": "merchantName111",
"merchantEmail": "[email protected]",
"status": "Filling",
"personalInformation": {
"nationality": "CN",
"identityType": "1",
"identityNumber": "identityNumber2222",
"firstName": "firstName",
"lastName": "lastName",
"firstNameCn": "firstNameCn11",
"lastNameCn": "lastNameCn22",
"dateOfBirth": "2025-10-10",
"expirationDateBegan": "2025-10-10",
"expirationDateEnded": "2035-10-10",
"residenceCountry": "CN",
"residenceProvince": "2247",
"residenceCity": "19598",
"residenceAddress": "15125123",
"residenceZip": "residenceZip",
"portraitFace": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1929803377366183936/kycAPI/abe944b2e61f4f958cd0560d478406f0.png?Expires=1765860861&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=wcgwpqW8tgnBhIeUEyjXxRWeXTc%3D",
"nationalEmblemSurface": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1929803377366183936/kycAPI/909a2dcdd84549f7bca9ac34a28cd973.jpg?Expires=1765860861&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=dxItudShjCio2JNVmpm%2F5j4vXu4%3D",
"proofOfAddress": [
"https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1929803377366183936/kycAPI/cc8f7f58f52244a1909fbd09e0f2c334.jpeg?Expires=1765860861&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=eX71vGsmJ28SXkIVoDoyykzhFog%3D"
],
"status": "Submitted",
"longTermEffectiveness": null
},
"linkToLiveVerification": {
"verificationLink": null,
"validityTime": null,
"status": null
},
"dynamicDataList": [
{
"configKey": "KYC_MERCHANT_BASIC",
"status": "Submitted",
"valueFramework": {
"transactionsNumber": "100",
"businessWebsiteList": [],
"funding": [
"salary_income",
"e_commerce_Platform",
"Advertising_Platform",
"Acquirer_Tool",
"Developer_Platform"
],
"averageCollectionAmount": "1000",
"Materials": [
"baseInfo/1929803377366183936/kycAPI/abe944b2e61f4f958cd0560d478406f0.png"
],
"applyProductList": [
"GLOBAL_RECEIVABLES"
],
"businessCountryList": [
"CN"
],
"EmploymentStatus": "Student",
"openingPurpose": "1111开户",
"tradingVolume": "1000",
"averagePaymentAmount": "1000"
}
},
{
"configKey": "KYC_MERCHANT_PAYER",
"status": "Submitted",
"valueFramework": {
"list": [
{
"country": "US",
"name": "名称11",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称22",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称32",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
}
]
}
},
{
"configKey": "KYC_MERCHANT_BENEFICIARY",
"status": "Submitted",
"valueFramework": {
"list": [
{
"country": "US",
"name": "名称11",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称22",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
},
{
"country": "US",
"name": "名称32",
"tradingVolume": {
"amount": "101",
"currency": "USD"
}
}
]
}
}
]
},
"success": true
}Updated about 11 hours ago