创建客户

创建个人客户信息并进行身份审核(KYC),用于后续开通银行转账收款账户。

请求地址(POST)

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

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

请求参数

Request Body

参数名类型必填说明
typeString是客户类型,目前仅支持个人 individual
firstNameString是名
lastNameString是姓
genderString是性别:M、F、X
nationalityString是国籍,ISO 3166-1 alpha-2 两位代码
dobString是出生日期,格式:yyyy-MM-dd,客户须年满 18 周岁
emailString是邮箱
phoneNumberString是手机号,包含区号,格式为+12125550198
countryCodeString否居住国家,ISO 3166-1 alpha-2 两位代码
addressObject是地址
├──stateString是州/省
├──cityString是城市
├──streetLine1String是街道地址1
├── streetLine2String否街道地址2
├── postalCodeString否邮编
passportNumberString条件必填护照号码,仅允许英文字母和数字,最长 100 字符;建档选择 AED 时必填
passportExpiryDateString条件必填护照有效期,格式:yyyy-MM-dd;建档选择 AED 时必填
passportCountryString条件必填护照签发国,ISO 3166-1 alpha-2 两位代码;建档选择 AED 时必填
sumsubIdString否sumsub 已认证的id,认证类型必须是个人
传递 sumsubId 时,基本资料从 Sumsub 获取,可省略以上个人资料;shareToken 必填,选择 AED 时仍须提交下方三个护照字段。
shareTokenString否传递 sumsubId 时必填
paymentTypeString否支付方式:eubanktransferva(EUR)、gbbanktransferva(GBP)、aebanktransferva(AED);不传仅建档,不触发渠道进件

说明

  1. shareToken字段说明:sumsub 跨平台数据共享令牌。调用方需向 sumsub 接口申请生成并再此传入。生成Token时,需将目标客户端ID(forClientId)参数值固定设置为:futurebank.global
  1. 三个护照字段必须一起提交或一起省略。建档选择 aebanktransferva 时,直接提交资料和使用 sumsubId + shareToken 两种方式都必须提交完整护照。
  2. 使用 Sumsub 共享资料时,请确保资料中包含完整居住地址,AED 渠道进件需要有效的街道地址。
  3. 已有客户加开其他支付方式,请调用「为已有客户加开账户」,无需重复建档。

请求示例

{
    "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;审核通过后,可通过「为已有客户加开账户」选择支付方式。

响应示例

参数类型描述
codeString返回代码,"0" 表示请求成功
msgString返回信息
serverTimeLong服务器时间戳
dataObject响应数据对象
├──customerIdString客户id
├──statusStringsumsub审核状态
PENDING 待审核 / APPROVED 已通过
successBoolean请求是否成功,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 通知返回银行信息,也可调用「查询虚拟银行卡信息」。后续支付复用已创建的账户。


Did this page help you?