为已有客户加开账户
为已通过身份审核(KYC)的个人客户开通其他银行转账支付方式,复用原 customerId,无需重复创建客户。本接口完成对应渠道进件;虚拟账户仍在首次使用该支付方式下单时申请开立。
请求地址(POST)
实时API:https://api.futurepay.global/payin/customers/accounts
沙盒API:https://api.futurepay-develop.com/payin/customers/accounts
请求参数
Request Body
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
customerId | String | 是 | 创建客户接口返回的客户id,须属于当前商户,且 KYC 状态为 APPROVED |
paymentType | String | 是 | 支付方式:eubanktransferva(EUR)、gbbanktransferva(GBP)、aebanktransferva(AED) |
passportNumber | String | 条件必填 | 护照号码,仅允许英文字母和数字,最长 100 字符;加开 AED 时须提供完整护照或复用已保存的完整护照 |
passportExpiryDate | String | 条件必填 | 护照有效期,格式:yyyy-MM-dd |
passportCountry | String | 条件必填 | 护照签发国,ISO 3166-1 alpha-2 两位代码 |
说明
- 加开 AED 时,可以完全省略三个护照字段,复用当前商户为该客户已保存的完整护照;没有已保存的完整护照时必须提交三个字段。不能仅凭 Sumsub 中存在护照而省略提交。
- 提交护照时,三个字段必须一起提交,不能仅传部分字段并与旧护照拼接。EUR/GBP 不要求护照,但提交时同样必须完整。
- AED 渠道进件尚未成功时,可通过本接口补充或更正护照并重试。进件已成功时不会通过本接口修改渠道中已有的护照资料。
- 本接口复用客户已有的身份和地址资料,不用于修改姓名或地址。AED 进件需要有效的街道地址;资料缺失时请联系 Future Pay 处理。
- 加开 EUR/GBP 的国籍限制与「创建客户」一致,不适用于 AED。
请求示例
已有客户加开 AED(提交完整护照):
{
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"paymentType": "aebanktransferva",
"passportNumber": "123456789",
"passportExpiryDate": "2030-12-31",
"passportCountry": "GB"
}已有客户加开 AED(复用已保存的完整护照):
{
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"paymentType": "aebanktransferva"
}已有客户加开 GBP:
{
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"paymentType": "gbbanktransferva"
}响应示例
| 参数 | 类型 | 描述 |
|---|---|---|
| code | String | 返回代码,"0" 表示请求成功 |
| msg | String | 返回信息 |
| serverTime | Long | 服务器时间戳,单位毫秒 |
| data | Object | 响应数据对象 |
├──customerId | String | 原客户id |
├──paymentType | String | 本次开通的支付方式 |
| success | Boolean | 请求是否成功,true 表示成功 |
成功响应示例:
{
"code": "0",
"msg": "success",
"serverTime": 1792981072858,
"data": {
"customerId": "FPeda1770136ff446292f75fe762e027d9",
"paymentType": "aebanktransferva"
},
"success": true
}请求成功表示对应渠道进件已确认,不表示虚拟账户已开立。本接口不返回 IBAN,也不返回开户成功状态。
常见错误
| 场景 | 返回信息示例 | 处理方式 |
|---|---|---|
| 客户不存在或不属于当前商户 | customerId is invalid | 使用当前商户创建客户返回的 customerId |
| KYC 尚未通过 | customer KYC not approved | 确认客户审核通过后再调用 |
| 缺少护照或护照格式不正确 | passportNumber is required (at most 100 characters)、passportExpiryDate must be yyyy-MM-dd | 提交符合格式要求的完整护照 |
| AED 渠道进件未成功 | customer account onboarding failed | 核对护照和已有地址资料,修正后重试;持续失败请联系 Future Pay |
| EUR/GBP 渠道进件未确认 | Openpayd onboarding is not confirmed, please check onboarding status | 联系 Future Pay 确认进件状态 |
后续流程
- 本接口成功后,使用返回的
customerId作为下单接口的shopperReference,paymentMethod.type使用已开通的支付方式,消费者级不传paymentMethod.subType。 - 首次下单申请对应币种的虚拟账户。开户尚未完成时,订单返回
PENDING且不含order账户信息。 - 等待
VA_ACTIVATED成功通知,或调用「查询虚拟银行卡信息」获取账户。开户通知不代表交易成功。
Updated about 9 hours ago
Did this page help you?