申请专业版专属账号接口
功能概述
商户提前通过接口向首信易申请 专业版专属账号。申请上限：5 万
接口地址
https://apis.5upay.com/cashier/eaccountpro/open
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一id，可在商户后台查看 |
M |
| requestId |
订单号 |
varchar(50) |
订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单，商户平台不能以相同的订单号再次提交。 |
M |
| partnerId |
服务商id |
varchar(9) |
服务商在首信易系统的唯一id，可在商户后台查看 |
C |
| count |
账号个数 |
varchar(9) |
申请账号的个数，支持批量申请，不超过 10 个。默认 1 个 |
O |
| offlineNotifyUrl |
到账通知地址 |
varchar(200) |
本次请求生成的专属账号，当接收到汇款时，会向该地址发送到账通知 |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId": "89***93",
"requestId": "MM20240225***59708708865C1",
"hmac": "WjMHAqMNl==",
"count": "2",
"partnerId": "",
"offlineNotifyUrl": "https://sdk.5upay.com/"
}
]]>
请求同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| requestId |
订单号 |
同请求参数 |
| partnerId |
服务商Id |
同请求参数 |
| count |
账号个数 |
同请求参数 |
| offlineNotifyUrl |
到账通知地址 |
同请求参数 |
| status |
请求状态 |
SUCCESS 成功，请求已接收 |
| ERROR 错误 |
| accountList |
账户列表 |
该笔订单申请开通的境内收单专业版专属账号信息，状态为SUCCESS 时返回此列表 |
| hmac |
参数签名 |
首信易生成的参数签名结果，验签过程请参考解密流程 |
accountList 账户列表
| 参数名称 |
参数中文名称 |
参数说明 |
| accountNumber |
账户号 |
专属账户的账户号 |
| accountName |
账户名称 |
专属账户的账户名称 |
示例
<![CDATA[
{
"merchantId": "89***93",
"requestId": "MM202402***08708865C1",
"accountList": [
{
"accountName": "首信易测试商户——首信易测试商户-技术支持部测试 1",
"accountNumber": "688800***0911"
},
{
"accountName": "首信易测试商户——首信易测试商户-技术支持部测试 1",
"accountNumber": "688800***0038"
}
],
"hmac": "ejaW6Y2rAXz1zmQ==",
"count": 2,
"partnerId": "",
"offlineNotifyUrl": "https://sdk.5upay.com/",
"status": "SUCCESS"
}
]]>