收款方

创建收款方

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`countryCode`	M	string	收款方银行所在国家/地区的国际标准化组织（ISO）两位国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准）
`accountCcy`	M	string	收款账户币种，固定USD
`paymentType`	M	string	收款方式，固定SWIFT
`accType`	M	string	账户类型(企业-company 个人-individual)
`accountName`	M	string	收款方名称
`cardNo`	M	string	收款方账号
`swiftCode`	M	string	swiftCode银行信息代码(查询银行信息参考)
`middleSwiftCode`	O	string	非必填；若填写，校验是否存在;银行信息代码(查询银行信息参考)
`routingCode`	M	string	收款行路由编号，若「收款币种」为「USD」,「收款国家/地区」为「美国」，校验必填;
`middleRoutingCode`	O	string	中间行路由编号，若填写校验必须为9位数字
`address`	M	string	收款方详细居住地址

调用的特定响应data参数

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

集成

创建收款方调用输入

{   
    "merchantReference":"xpoiasdiuqwenj23890",
    "countryCode":"US",
    "accountCcy":"USD",
    "paymentType":"SWIFT",
    "accType":"company",
    "accountName":"000 simple sentence.",
    "cardNo":"987654221",
    "swiftCode":"MRBAEGCX018",
    "address":"Macy Alameda Spring and Arcadia streets",
    "middleSwiftCode":"MRBAEGCX018",
    "routingCode":"987654321"
}

创建收款方调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1738831561912,
    "data": {
        "merchantReference": "xpoiasdiuqwenj23890",
        "payeeId": "632",
        "resultCode": "REVIEW"
    },
    "success": true
}

查询收款方

端点目标 URL

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

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

字段说明

调用的特定输入参数

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

调用的特定响应data参数

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

集成

查询收款方调用输入

{   
    "merchantReference":"xpoiasdiuqwenj23890"
}

查询收款方调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1738831610618,
    "data": {
        "merchantReference": "xpoiasdiuqwenj23890",
        "payeeId": "632",
        "resultCode": "ACCEPT"
    },
    "success": true
}

WEBHOOK

{
    "appId":"1864861460728012800",
    "merchantId":"1864861460719644672",
    "notificationItems":[
        {
            "eventCode":"CREATE_RECEIVER_RESULT",
            "eventDate":1738831562027,
            "merchantReference":"81092123hkjhaew124",
            "payeeId":632,
            "resultCode":"ACCEPT"
        }
    ]
}

Updated 6 days ago