请求地址（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
`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	否	邮编
`sumsubId`	String	否	sumsub 已认证的id，认证类型必须是个人当传递了sumsubId，以上必填参数可忽略。
`shareToken`	String	否	传递 sumsubId 时必填
`paymentType`	String	是	支付方式，值为`gbbanktransferva`

说明

shareToken字段说明：sumsub 跨平台数据共享令牌。调用方需向 sumsub 接口申请生成并再此传入。生成Token时，需将目标客户端ID（forClientId）参数值固定设置为：futurebank.global
以下国家暂不支持开通GB银行转账支付方式：

AF,AL,AQ,AM,AZ,BB,BY,BW,BF,BI,KH,CV,CF,CD,CU,GH,GN,GW,HT,IR,IQ,JM,JP,JO,KZ,KP,KG,LA,LY,ML,MA,MZ,MM,NI,PK,PS,PA,RU,SN,SO,SS,SD,SY,TJ,TZ,TL,TT,TN,TM,UG,UA,US,UZ,VU,VE,YE,ZW

请求示例

{
  "type": "individual",
  "firstName": "Oliver",
  "lastName": "Bennett",
  "dob": "1991-03-24",
  "gender": "M",
  "email": "[email protected]",
  "nationality": "GB",
  "phoneNumber": "7700900123",
  "countryCode": "GB",
  "address": {
    "state": "Greater London",
    "city": "London",
    "streetLine1": "42 Baker Street",
    "streetLine2": "Flat 6",
    "postalCode": "W1U 7AL"
  },
  "paymentType": "gbbanktransferva"
}

{
    "sumsubId": "6a7d7a3c1527bc9429f4b046",
    "shareToken": "_act-sbx-jwt-eyJhbGciOiJub25lIn0.eyJqdGkiOiJfYWN0LXNieC1kNjcwMDA2YS04NzYwLTQ1MWYtOGI4MC0yMDU1Nzc0MWI5N2EiLCJ1cmwiOiJodHRwczovL2FwaS5zdW1zdWIuY29tIn0.",
    "paymentType": "gbbanktransferva"
}

响应示例

参数	类型	描述
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 一致。

说明

创建客户后不会立即生成虚拟账户。

客户首次使用 GBP BankTransfer 支付方式时，系统才会申请创建 EUR 虚拟账户。账户创建成功后，相关银行账户信息将通过异步通知返回；后续支付将复用已创建的虚拟账户。