网关签约信息查询

接口描述

• 查询网关签约信息列表，支持分页查询。
• 支持按商户号、证件信息、银行行号等条件查询签约记录。

请求 URL

• /quickPay/gatewaySignQueryList

请求方式

• POST

公共请求参数

参数名	必选	类型	最大长度	说明	示例
appId	是	string		appId	202415629590370906
signature	是	string		签名
transNonce	是	string	32	请求流水号	43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate	是	string	13	请求时间，13 位时间戳	1731406784607

请求参数

参数名	必选	类型	最大长度	说明	示例
signBizType	是	string		签约业务类型：01-快捷；02-商委	01
merchantNo	否	string		商户号 (签约业务类型=02 时必填)	2024112000001001
certType	否	string		证件类型;ID_CARD-身份证	ID_CARD
certNo	否	string		证件号 (需加密)
bankNo	否	string		银行行号	102100099996
cardType	否	string		卡类型;DC:借记卡，CC:贷记卡	DC
pageNo	否	Long		页码 (默认 1)	1
pageSize	否	Long		页大小 (默认 10)	10

响应参数

参数名	必选	类型	最大长度	说明	示例
code	是	string		响应编码	00000000
message	是	string		响应信息	成功
merchantNo	否	string		商户号	2024112000001001
certType	否	string		证件类型;ID_CARD-身份证	ID_CARD
certNo	否	string		证件号
signInfoList	是	string		签约信息列表 (JSON 数组字符串)	-
- bankNo	否	string		银行行号	102100099996
- cardType	否	string		卡类型;DC:借记卡，CC:贷记卡	DC
- cardNoMask	否	string		卡号掩码（脱敏显示）	622202***********1234
- signNo	否	string		签约编号	2024112000001001
- signBizType	否	string		签约业务类型：01-快捷；02-商委	01
- signStatus	否	string		签约状态;SIGNED:已签约，TERMINATED:已解约	SIGNED
current	是	long		当前页	1
pageSize	是	long		页大小	10
total	是	long		总数	100
totalPage	是	long		总页数	10
signature	是	string		签名
transNonce	是	string	32	请求流水号 (同入参)	43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate	是	string	13	请求时间，13 位时间戳	1731406784607

响应示例

{
    "code": "00000000",
    "message": "成功",
    "merchantNo": "2024112000001001",
    "certType": "ID_CARD",
    "certNo": "110101199001011234",
    "signInfoList": "[{\"bankNo\":\"102100099996\",\"cardType\":\"DC\",\"cardNoMask\":\"622202*********1234\",\"signNo\":\"2024112000001001\",\"signBizType\":\"01\",\"signStatus\":\"SIGNED\"},{\"bankNo\":\"102100099997\",\"cardType\":\"DC\",\"cardNoMask\":\"622700*********5678\",\"signNo\":\"2024112000001002\",\"signBizType\":\"01\",\"signStatus\":\"SIGNED\"}]",
    "current": 1,
    "pageSize": 10,
    "total": 2,
    "totalPage": 1,
    "transDate": "1731469621597",
    "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
    "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}

备注

• 更多返回错误代码请看 通用规则说明 - 错误码 的错误代码描述
• signBizType 为必填项，可选值为 01（快捷）或 02（商委）
• 当 signBizType=02 时，merchantNo 为必填项
• certNo 字段需要使用 AES 加密传输
• signInfoList 返回的是 JSON 数组格式的字符串，需要进行二次解析
• cardNoMask 为卡号脱敏后的显示格式
• signStatus 枚举值：SIGNED（已签约）、TERMINATED（已解约）
• 默认分页参数：pageNo=1，pageSize=10