为已有客户加开账户

为已通过身份审核(KYC)的个人客户开通其他银行转账支付方式,复用原 customerId,无需重复创建客户。本接口完成对应渠道进件;虚拟账户仍在首次使用该支付方式下单时申请开立。

请求地址(POST)

实时API:https://api.futurepay.global/payin/customers/accounts

沙盒API:https://api.futurepay-develop.com/payin/customers/accounts

请求参数

Request Body

参数名类型必填说明
customerIdString是创建客户接口返回的客户id,须属于当前商户,且 KYC 状态为 APPROVED
paymentTypeString是支付方式:eubanktransferva(EUR)、gbbanktransferva(GBP)、aebanktransferva(AED)
passportNumberString条件必填护照号码,仅允许英文字母和数字,最长 100 字符;加开 AED 时须提供完整护照或复用已保存的完整护照
passportExpiryDateString条件必填护照有效期,格式:yyyy-MM-dd
passportCountryString条件必填护照签发国,ISO 3166-1 alpha-2 两位代码

说明

  1. 加开 AED 时,可以完全省略三个护照字段,复用当前商户为该客户已保存的完整护照;没有已保存的完整护照时必须提交三个字段。不能仅凭 Sumsub 中存在护照而省略提交。
  2. 提交护照时,三个字段必须一起提交,不能仅传部分字段并与旧护照拼接。EUR/GBP 不要求护照,但提交时同样必须完整。
  3. AED 渠道进件尚未成功时,可通过本接口补充或更正护照并重试。进件已成功时不会通过本接口修改渠道中已有的护照资料。
  4. 本接口复用客户已有的身份和地址资料,不用于修改姓名或地址。AED 进件需要有效的街道地址;资料缺失时请联系 Future Pay 处理。
  5. 加开 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"
}

响应示例

参数类型描述
codeString返回代码,"0" 表示请求成功
msgString返回信息
serverTimeLong服务器时间戳,单位毫秒
dataObject响应数据对象
├──customerIdString原客户id
├──paymentTypeString本次开通的支付方式
successBoolean请求是否成功,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 确认进件状态

后续流程

  1. 本接口成功后,使用返回的 customerId 作为下单接口的 shopperReference,paymentMethod.type 使用已开通的支付方式,消费者级不传 paymentMethod.subType。
  2. 首次下单申请对应币种的虚拟账户。开户尚未完成时,订单返回 PENDING 且不含 order 账户信息。
  3. 等待 VA_ACTIVATED 成功通知,或调用「查询虚拟银行卡信息」获取账户。开户通知不代表交易成功。

Did this page help you?