创建客户
创建个人客户信息并进行身份审核(KYC),用于后续开通银行转账收款账户。
请求地址(POST)
实时API:https://api.futurepay.global/payin/customers
沙盒API:https://api.futurepay-develop.com/payin/customers
请求参数
Request Body
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | String | 是 | 客户类型,目前仅支持个人 individual |
firstName | String | 是 | 名 |
lastName | String | 是 | 姓 |
gender | String | 是 | 性别:M、F、X |
nationality | String | 是 | 国籍,ISO 3166-1 alpha-2 两位代码 |
dob | String | 是 | 出生日期,格式:yyyy-MM-dd,客户须年满 18 周岁 |
email | String | 是 | 邮箱 |
phoneNumber | String | 是 | 手机号,包含区号,格式为+12125550198 |
countryCode | String | 否 | 居住国家,ISO 3166-1 alpha-2 两位代码 |
address | Object | 是 | 地址 |
├──state | String | 是 | 州/省 |
├──city | String | 是 | 城市 |
├──streetLine1 | String | 是 | 街道地址1 |
├── streetLine2 | String | 否 | 街道地址2 |
├── postalCode | String | 否 | 邮编 |
passportNumber | String | 条件必填 | 护照号码,仅允许英文字母和数字,最长 100 字符;建档选择 AED 时必填 |
passportExpiryDate | String | 条件必填 | 护照有效期,格式:yyyy-MM-dd;建档选择 AED 时必填 |
passportCountry | String | 条件必填 | 护照签发国,ISO 3166-1 alpha-2 两位代码;建档选择 AED 时必填 |
sumsubId | String | 否 | sumsub 已认证的id,认证类型必须是个人 传递 sumsubId 时,基本资料从 Sumsub 获取,可省略以上个人资料;shareToken 必填,选择 AED 时仍须提交下方三个护照字段。 |
shareToken | String | 否 | 传递 sumsubId 时必填 |
paymentType | String | 否 | 支付方式:eubanktransferva(EUR)、gbbanktransferva(GBP)、aebanktransferva(AED);不传仅建档,不触发渠道进件 |
说明
- shareToken字段说明:sumsub 跨平台数据共享令牌。调用方需向 sumsub 接口申请生成并再此传入。生成Token时,需将目标客户端ID(forClientId)参数值固定设置为:futurebank.global
- 三个护照字段必须一起提交或一起省略。建档选择
aebanktransferva时,直接提交资料和使用sumsubId + shareToken两种方式都必须提交完整护照。 - 使用 Sumsub 共享资料时,请确保资料中包含完整居住地址,AED 渠道进件需要有效的街道地址。
- 已有客户加开其他支付方式,请调用「为已有客户加开账户」,无需重复建档。
请求示例
{
"type": "individual",
"firstName": "Oliver",
"lastName": "Bennett",
"dob": "1991-03-24",
"gender": "M",
"email": "[email protected]",
"nationality": "GB",
"phoneNumber": "+447700900123",
"countryCode": "GB",
"address": {
"state": "Greater London",
"city": "London",
"streetLine1": "42 Baker Street",
"postalCode": "W1U 7AL"
},
"paymentType": "aebanktransferva",
"passportNumber": "123456789",
"passportExpiryDate": "2030-12-31",
"passportCountry": "GB"
}不传
paymentType时,仅创建客户并进行 KYC;审核通过后,可通过「为已有客户加开账户」选择支付方式。
响应示例
| 参数 | 类型 | 描述 |
|---|---|---|
| code | String | 返回代码,"0" 表示请求成功 |
| msg | String | 返回信息 |
| serverTime | Long | 服务器时间戳 |
| data | Object | 响应数据对象 |
├──customerId | String | 客户id |
├──status | String | sumsub审核状态PENDING 待审核 / APPROVED 已通过 |
| success | Boolean | 请求是否成功,true 表示成功 |
成功响应示例:
{
"code": "0",
"msg": "success",
"serverTime": 1787035547492,
"data": {
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"status": "PENDING"
},
"success": true
}结果通知
当 sumsub 扫描完成后会通过商户端配置的Webhook进行回调,告知客户扫描结果。
Webhook回调请求参数:
{
"merchantId": "2076614224058167296",
"appId": "2076614224167198720",
"notificationItems": [
{
"eventCode": "SUMSUB_REVIEW_COMPLETED",
"customId": "FPeda1770136ff446292f75fe762e027d9",
"status": "APPROVED",
"eventDate": 1787035551128
}
]
}
status取值:
APPROVED(审核通过)REJECTED(审核拒绝)
customId与创建客户接口返回的customerId一致。
说明
创建客户后不会立即生成虚拟账户。status: APPROVED 或 SUMSUB_REVIEW_COMPLETED 通知仅表示 KYC 通过,不表示渠道进件或 VA 开户成功。
建档时选择支付方式的客户,在 KYC 通过后触发对应渠道进件。渠道进件完成后,首次使用对应支付方式下单时才申请该币种的虚拟账户(GBP、EUR 或 AED);账户开好后通过 VA_ACTIVATED 通知返回银行信息,也可调用「查询虚拟银行卡信息」。后续支付复用已创建的账户。
Updated about 9 hours ago
Did this page help you?