请求地址（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，以上必填参数可忽略

请求示例：

{
    "type": "individual",
    "firstName": "Michael",
    "lastName": "Smith",
    "dob": "1998-04-12",
    "gender": "M",
    "nationality": "US",
    "email": "[email protected]",
    "phoneNumber": "+12125550198",
    "countryCode": "US",
    "address": {
        "state": "New York",
        "city": "New York",
        "streetLine1": "350 5th Avenue",
        "streetLine2": "Apt 42B",
        "postalCode": "10118"
    }
}

{
    "sumsubId": "6a7d7a3c1527bc9429f4b046"
}

响应示例

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