专业版专属账号信息查询

功能概述

商户通过此接口查询专业版专属账号信息

同一个商户一个小时内请求次数不能超过 5 次

接口地址

https://apis.5upay.com/cashier/eaccountpro/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 M
partnerId 服务商id varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
startDate 开始日期 varchar(10) 查询时间范围的开始日期,可查询一段时间内成功创建的账户信息,最多可查 7 天格式:yyyy-MM-dd,需小于等于当前日期 O
endDate 结束日期 varchar(10) 查询时间范围的结束日期,可查询一段时间内成功创建的账户信息,最多可查 7 天格式:yyyy-MM-dd,需小于等于当前日期、大于等于开始日期 M
queryPageNo 查询页数 int(3) 本次查询的页数,第一次请求传 1 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "89***593", "endDate": "2024-11-18", "requestId": "173***6994", "hmac": "s2B4hPcUKVBdotg==", "partnerId": "", "startDate": "2024-11-18", "queryPageNo": 1 }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
partnerId 服务商Id 同请求参数
startDate 开始日期 同请求参数
endDate 结束日期 同请求参数
queryPageNo 查询页数 同请求参数
status 请求状态 SUCCESS 成功
ERROR 错误
count 总账户个数 所查时间范围内的账户总个数,状态为 SUCCESS 时返回
totalPageNo 总页数 所查时间范围内的账户数据总页数,每页 1 万条数据,状态为 SUCCESS 时返回
accountList 账户列表 该时间范围内成功创建的境内收单专业版专属账户信息,状态为 SUCCESS 时返回此列表
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

accountList 账户列表

参数名称 参数中文名称 参数说明
accountNumber 账户号 专属账户的账户号
accountName 账户名称 专属账户的账户名称
accountStatus 账户状态 专属账户的当前状态
AVAILABLE 可用
CLOSED 关闭
offlineNotifyUrl 到账通知地址 专属账户的账户名称

示例

{ "endDate": "2024-11-18", "merchantId": "89***93", "requestId": "173***66994", "accountList": [ { "accountStatus": "AVAILABLE", "accountName": "首信易测试商户——首信易测试商户-技术支持部测试 1", "accountNumber": "688800***0911", "offlineNotifyUrl": "https://sdk.5upay.com/" }, { "accountStatus": "AVAILABLE", "accountName": "首信易测试商户——首信易测试商户-技术支持部测试 1", "accountNumber": "688800***0038", "offlineNotifyUrl": "https://sdk.5upay.com/" } ], "hmac": "PATlPDXXJroBA0ha8T55w==", "count": 2, "partnerId": "", "totalPageNo": 1, "queryPageNo": 1, "startDate": "2024-11-18", "status": "SUCCESS" }