付款方

创建付款方

端点目标 URL

沙盒环境请求地址：POST https://api.futurepay-develop.com/api/v1/payer/create

生产环境请求地址：POST https://api.futurepay.global/api/v1/payer/create

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`payerType`	O	int	付款人类型，固定为「合作伙伴」, 枚举值为：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	付款方详细居住地址

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`payerId`	String	付款方Id
`resultCode`	String	付款方状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中)

集成

创建付款方调用输入

{   
    "merchantReference":"81092123hkjhaew124",
    "identityNationalityCode":"CN",
    "firstName":"jorn",
    "lastName":"huyawe",
    "identityNumber":"G22222224CHN85101",
    "identitySex":"1",
    "identityType":"2",
    "identityBirthday":"2025-01-22",
    "residenceCountryCode":"CN",
    "residenceAddress":"广东省广州市越秀区东风中路305号"
}

创建付款方调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1738828807346,
    "data": {
        "merchantReference": "81092123hkjhaew124",
        "payerId": "314",
        "resultCode": "REVIEW"
    },
    "success": true

在创建付款人后，请及时调用文件上传接口上传人员证件信息;文件上传

查询付款方

端点目标 URL

沙盒环境请求地址：POST https://api.futurepay-develop.com/api/v1/payer/get-payer-status

生产环境请求地址：POST https://api.futurepay.global/api/v1/payer/get-payer-status

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	创建付款方时商户提交的请求流水号

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`payerId`	String	付款方Id
`resultCode`	String	付款方状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中)

集成

查询付款方调用输入

{
    "merchantReference":"81092123hkjhaew124"
}

查询付款方调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1738829399457,
    "data": {
        "merchantReference": "81092123hkjhaew124",
        "payerId": "314",
        "resultCode": "REVIEW"
    },
    "success": true
}

WEBHOOK

{
    "appId":"1864861460728012800",
    "merchantId":"1864861460719644672",
    "notificationItems":[
        {
            "eventCode":"CREATE_PAYER_RESULT",
            "eventDate":1737613810829,
            "merchantReference":"81092123hkjhaew124",
            "payerId":314,
            "resultCode":"ACCEPT"
        }
    ]
}

Updated 6 days ago