账户持有人
创建账户持有人
端点目标 URL
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
merchantReference | M | string | 商户请求流水号，不能重复 |
holderType | M | string | 持有人类型(0-注册人 1-受益人 2-法人 3-董事 4-股东 5-员工 6-其他 7-合作伙伴) |
identityNationalityCode | M | string | 持有人证件所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
firstName | M | string | 持有人名字 |
lastName | M | string | 持有人姓式 |
identityNumber | M | string | 持有人证件号码 |
identitySex | M | string | 持有人性别(1-男性，2-女性) |
identityType | M | string | 持有人证件类型（1-身份证，2-护照） |
identityBirthday | M | string | 持有人出生日期（yyyy-MM-dd格式） |
residenceCountryCode | M | string | 持有人居住所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
residenceAddress | M | string | 持有人详细居住地址 |
residenceProvince | M | string | 持有人居住地址所在省/州 |
residenceCity | M | string | 持有人居住地址所在市 |
email | M | string | 持有人邮箱 |
zipCode | M | string | 持有人居住所在地邮编 |
certImageFontId | M | string | 正面文件照材料id |
certImageBackId | O | string | 反面文件照材料id(若证件类型为身份证，该值必填) |
响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
merchantReference | String | 商户请求流水号 |
accountType | String | 持有人类型 |
accountHolderId | String | 持有人Id |
resultCode | String | 持有人状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中) |
errorMsg | String | 失败原因 |
identityType | String | 持有人证件类型（1-身份证，2-护照） |
email | String | 持有人邮箱 |
fullName | String | 全名 |
identitySex | String | 持有人性别(1-男性，2-女性) |
identityNationalityCode | String | 付款方证件所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
identityBirthday | String | 持有人出生日期（yyyy-MM-dd格式） |
identityNumber | String | 持有人证件号码 |
residenceCountryCode | String | 持有人居住所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
residenceAddress | String | 持有人详细居住地址 |
residenceProvinceName | String | 持有人居住地址所在省/州 |
residenceCityName | String | 持有人居住地址所在市 |
zipCode | String | 持有人居住所在地邮编 |
createTime | String | 创建时间 |
updateTime | String | 修改时间 |
集成
创建持有人调用输入
{
"merchantReference":"12cc3zxczzxcccccxcqq",
"identityBirthday":"2000-01-12",
"firstName":"志华",
"lastName":"王",
"identitySex":1,
"identityType":2,
"identityNationalityCode":"CN",
"residenceCountryCode":"CN",
"residenceProvince":"hunan",
"residenceCity":"chenzhou",
"residenceAddress":"asdasd",
"identityNumber":"wedd5456dcddddd",
"zipCode":"123456",
"certImageFontId":"176303082145977062456",
"email":"[email protected]",
"holderType":"1"
}创建持有人调用输出
{
"code": "0",
"msg": "succeeded",
"serverTime": 1763435805271,
"data": {
"merchantReference": "12cc3zxczzxcccccxcqq",
"accountType": "individual",
"accountHolderId": "509",
"resultCode": "REVIEW",
"errorMsg": "",
"holderType": 1,
"identityType": 2,
"email": "[email protected]",
"fullName": "志华 王",
"identitySex": "1",
"identityNationalityCode": "CN",
"identityBirthday": "2000-01-12",
"identityNumber": "wedd5456dcddddd",
"residenceCountryCode": "CN",
"residenceAddress": "asdasd",
"residenceProvinceName": "hunan",
"residenceCityName": "chenzhou",
"validityList": [],
"zipCode": "123456",
"createTime": "2025-11-18 03:16:45",
"updateTime": "2025-11-18 03:16:45"
},
"success": true
}修改账户持有人
端点目标 URL
生产环境请求地址：POST https://api.futurepay.global/api/v1/payer/update
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
merchantReference | M | string | 创建持有人时请求流水号 |
residenceCountryCode | M | string | 持有人居住所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
residenceAddress | M | string | 持有人详细居住地址 |
residenceProvince | M | string | 持有人居住地址所在省/州 |
residenceCity | M | string | 持有人居住地址所在市 |
email | M | string | 持有人邮箱 |
zipCode | M | string | 持有人居住所在地邮编 |
响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
merchantReference | String | 商户请求流水号 |
accountType | String | 持有人类型 |
accountHolderId | String | 持有人Id |
resultCode | String | 持有人状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中) |
errorMsg | String | 失败原因 |
identityType | String | 持有人证件类型（1-身份证，2-护照） |
email | String | 持有人邮箱 |
fullName | String | 全名 |
identitySex | String | 持有人性别(1-男性，2-女性) |
identityNationalityCode | String | 持有人证件所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
identityBirthday | String | 持有人出生日期（yyyy-MM-dd格式） |
identityNumber | String | 持有人证件号码 |
residenceCountryCode | String | 持有人居住所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
residenceAddress | String | 持有人详细居住地址 |
residenceProvinceName | String | 持有人居住地址所在省/州 |
residenceCityName | String | 持有人居住地址所在市 |
zipCode | String | 持有人居住所在地邮编 |
createTime | String | 创建时间 |
updateTime | String | 修改时间 |
集成
修改持有人调用输入
{
"merchantReference":"12cc3zxczzxcccccxcqq",
"residenceCountryCode":"CN",
"residenceProvince":"hunan",
"residenceCity":"chenzhou",
"residenceAddress":"asdasd",
"zipCode":"123456",
"email":"[email protected]"
}修改持有人调用输出
{
"code": "0",
"msg": "succeeded",
"serverTime": 1763436037719,
"data": {
"merchantReference": "12cc3zxczzxcccccxcqq",
"accountType": "individual",
"accountHolderId": "509",
"resultCode": "REVIEW",
"errorMsg": "",
"holderType": 1,
"identityType": 2,
"email": "[email protected]",
"fullName": "志华 王",
"identitySex": "1",
"identityNationalityCode": "CN",
"identityBirthday": "2000-01-12",
"identityNumber": "wedd5456dcddddd",
"residenceCountryCode": "CN",
"residenceAddress": "asdasd",
"residenceProvinceName": "hunan",
"residenceCityName": "chenzhou",
"validityList": [],
"zipCode": "123456",
"createTime": "2025-11-18 03:16:45",
"updateTime": "2025-11-18 03:16:47"
},
"success": true
}查询付款方列表
端点目标 URL
生产环境请求地址：POST https://api.futurepay.global/api/v1/account-holder/list
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
accountType | M | string | 持有人类型(企业-company 个人-individual) |
resultCode | O | string | 持有人状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中) |
holderType | O | string | 持有人类型 |
pageNum | O | string | 当前页 |
pageSize | O | string | 每页大小 |
集成
查询持有人列表调用输入
{
"pageNum":"1",
"pageSize":"5",
"resultCode":"ACCEPT",
"accountType":"individual"
}查询持有人列表调用输出
{
"code": "0",
"msg": "succeeded",
"serverTime": 1763437365866,
"data": {
"list": [
{
"merchantReference": "12cc3zxczzxccxcqq",
"accountType": "individual",
"accountHolderId": "506",
"resultCode": "ACCEPT",
"errorMsg": "",
"holderType": 1,
"identityType": 2,
"email": "[email protected]",
"fullName": "文在那个 李锕",
"identitySex": "1",
"identityNationalityCode": "CN",
"identityBirthday": "2000-01-12",
"identityNumber": "wedd5456dcddddd",
"residenceCountryCode": "CN",
"residenceAddress": "asdasd",
"residenceProvinceName": "hunan",
"residenceCityName": "chenzhou",
"validityList": [
{
"currency": "GBP",
"num": 9
},
{
"currency": "EUR",
"num": 10
},
{
"currency": "USD",
"num": 10
},
{
"currency": "AED",
"num": 10
}
],
"zipCode": "12345cccc6",
"createTime": "2025-11-13 11:39:59",
"updateTime": "2025-11-14 02:47:55"
},
{
"merchantReference": "",
"accountType": "individual",
"accountHolderId": "214",
"resultCode": "ACCEPT",
"errorMsg": "",
"holderType": 5,
"identityType": 1,
"email": "",
"fullName": "鹏程 殷",
"identitySex": "2",
"identityNationalityCode": "CN",
"identityBirthday": "1994-08-20",
"identityNumber": "320981199408203470",
"residenceCountryCode": "CN",
"residenceAddress": "东台市东台镇长青居委会五组43号",
"residenceProvinceName": "江苏省",
"residenceCityName": "盐城市",
"validityList": [
{
"currency": "GBP",
"num": 10
},
{
"currency": "EUR",
"num": 10
},
{
"currency": "USD",
"num": 10
},
{
"currency": "AED",
"num": 10
}
],
"zipCode": "224000",
"createTime": "2025-10-17 08:59:41",
"updateTime": "2025-10-17 10:30:52"
},
{
"merchantReference": "",
"accountType": "individual",
"accountHolderId": "208",
"resultCode": "ACCEPT",
"errorMsg": "",
"holderType": 0,
"identityType": 1,
"email": "[email protected]",
"fullName": "u i",
"identitySex": "2",
"identityNationalityCode": "AF",
"identityBirthday": "2024-09-11",
"identityNumber": "222222222222",
"residenceCountryCode": "AD",
"residenceAddress": "ew",
"residenceProvinceName": "La Massana",
"residenceCityName": "Arinsal",
"validityList": [
{
"currency": "GBP",
"num": 10
},
{
"currency": "EUR",
"num": 10
},
{
"currency": "USD",
"num": 10
},
{
"currency": "AED",
"num": 10
}
],
"zipCode": "42222",
"createTime": "2025-09-30 02:45:40",
"updateTime": "2025-09-30 02:53:52"
},
{
"merchantReference": "",
"accountType": "individual",
"accountHolderId": "176",
"resultCode": "ACCEPT",
"errorMsg": "",
"holderType": 0,
"identityType": 2,
"email": "[email protected]",
"fullName": "lehausid aysgawae",
"identitySex": "2",
"identityNationalityCode": "HK",
"identityBirthday": "2025-07-01",
"identityNumber": "asdzxcasdasdzxc",
"residenceCountryCode": "HK",
"residenceAddress": "weiduoliyagang",
"residenceProvinceName": "",
"residenceCityName": "",
"validityList": [
{
"currency": "GBP",
"num": 7
},
{
"currency": "EUR",
"num": 10
},
{
"currency": "USD",
"num": 10
},
{
"currency": "AED",
"num": 10
}
],
"zipCode": "123123",
"createTime": "2025-07-21 03:59:03",
"updateTime": "2025-07-24 02:38:47"
},
{
"merchantReference": "",
"accountType": "individual",
"accountHolderId": "146",
"resultCode": "ACCEPT",
"errorMsg": "",
"holderType": 2,
"identityType": 1,
"email": "[email protected]",
"fullName": "iiii ccccccc",
"identitySex": "2",
"identityNationalityCode": "DZ",
"identityBirthday": "2025-06-03",
"identityNumber": "zxczxc",
"residenceCountryCode": "AD",
"residenceAddress": "zxczxc",
"residenceProvinceName": "",
"residenceCityName": "",
"validityList": [
{
"currency": "GBP",
"num": 9
},
{
"currency": "EUR",
"num": 10
},
{
"currency": "USD",
"num": 10
},
{
"currency": "AED",
"num": 10
}
],
"zipCode": "zxczxc",
"createTime": "2025-06-26 10:50:57",
"updateTime": "2025-07-24 02:38:47"
}
],
"pageNum": 1,
"pageSize": 5,
"total": 6
},
"success": true
}查询持有人详情
查询持有人详情
端点目标 URL
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
merchantReference | M | string | 创建持有人时请求流水号 |
响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
merchantReference | String | 商户请求流水号 |
accountHolderId | String | 持有人Id |
resultCode | String | 持有人状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中) |
errorMsg | String | 失败原因 |
identityType | String | 持有人证件类型（1-身份证，2-护照） |
email | String | 持有人邮箱 |
fullName | String | 全名 |
identitySex | String | 持有人性别(1-男性，2-女性) |
identityNationalityCode | String | 持有人证件所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
identityBirthday | String | 持有人出生日期（yyyy-MM-dd格式） |
identityNumber | String | 持有人证件号码 |
residenceCountryCode | String | 持有人居住所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
residenceAddress | String | 持有人详细居住地址 |
residenceProvinceName | String | 持有人居住地址所在省/州 |
residenceCityName | String | 持有人居住地址所在市 |
zipCode | String | 持有人居住所在地邮编 |
validityList | List | 持有人居住地址所在市 |
validityList[i].currency | String | 持有人开户币种 |
validityList[i].num | String | 持有人开户币种最大开户数量 |
createTime | String | 创建时间 |
updateTime | String | 修改时间 |
集成
查询持有人调用输入
{
"merchantReference":"12cc3zxczzxccxcqq"
}查询持有人调用输出
{
"code": "0",
"msg": "succeeded",
"serverTime": 1763437765725,
"data": {
"merchantReference": "12cc3zxczzxccxcqq",
"accountType": "individual",
"accountHolderId": "506",
"resultCode": "ACCEPT",
"errorMsg": "",
"holderType": 1,
"identityType": 2,
"email": "[email protected]",
"fullName": "文在那个 李锕",
"identitySex": "1",
"identityNationalityCode": "CN",
"identityBirthday": "2000-01-12",
"identityNumber": "wedd5456dcddddd",
"residenceCountryCode": "CN",
"residenceAddress": "asdasd",
"residenceProvinceName": "hunan",
"residenceCityName": "chenzhou",
"validityList": [
{
"currency": "GBP",
"num": 9
},
{
"currency": "EUR",
"num": 10
},
{
"currency": "USD",
"num": 10
},
{
"currency": "AED",
"num": 10
}
],
"zipCode": "12345cccc6",
"createTime": "2025-11-13 11:39:59",
"updateTime": "2025-11-14 02:47:55"
},
"success": true
}WEBHOOK
{
"appId": "1929723739684102144",
"merchantId": "1929723739654762496",
"notificationItems": [
{
"eventCode": "CREATE_ACCOUNT_HOLDER_RESULT",
"accountHolderId": 509,
"resultCode": "ACCEPT",
"merchantReference": "12cc3zxczzxcccccxcqq",
"errorMsg": "",
"eventDate": 1763444364511
}
]
}Updated about 15 hours ago