交易请求报文
JSON:
{
"request_type": "merchant_settlementquery_request",
"isspid": "00058307",
"pos_seq": "2022112500001",
"system_id": "8888",
"merchant_settlementquery_request": {
"merchant_id": [
1001301,
1001301
],
"begin_date": "2023-03-23",
"end_date": "2023-03-23",
"page_size": 10,
"page_num": 1
},
"sign": "712036C2324D76F2934C44C95A80CEBA"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>merchant_settlementquery_request</request_type>
<isspid>00058301</isspid>
<pos_seq>2022112500001</pos_seq>
<system_id>8888</system_id>
<merchant_settlementquery_request>
<merchant_id>[]</merchant_id>
<begin_date>2023-03-23</begin_date>
<end_date>2023-03-23</end_date>
<page_size>10</page_size>
<page_num>1</page_num>
</merchant_settlementquery_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:merchant_settlementquery_request | 必填 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_seq | 终端流水号 | String(32) | 同一个商户必须唯一,且大于12位 | 必填 |
merchant_settlementquery_request ->merchant_id | 分账商户id | Array | 分账商户id | 必填 |
merchant_settlementquery_request ->begin_date | 开始日期 | String | 格式:yyyy-MM-dd | 必填 |
merchant_settlementquery_request ->end_date | 结束日期 | String | 格式:yyyy-MM-dd;交易开始和结束日期需小于等于7天 | 必填 |
merchant_settlementquery_request ->page_size | 分页条数 | Number | 每页数量不能超过1000 | 必填 |
merchant_settlementquery_request ->page_num | 分页页码 | Number | 不传则默认为第1页 | 可选 |
交易返回报文
JSON:
{
"response_type": "merchant_settlementquery_response",
"isspid": "00058307",
"pos_seq": "2022112500001",
"trans_time": "20230324142833",
"list": [
{
"trans_id": "1000485308838536",
"merchant_id": "1000200",
"trans_date": "20230323",
"trans_amount": 1,
"fee_amount": 0,
"fee_amount_yuan": "0.00",
"settle_cycle": "T1",
"settle_type": "1",
"card_no": "621700*********9289",
"card_name": "陈xx",
"bank_code": "01050000",
"trans_stat": "s"
}
],
"total": 1,
"page_num": 1,
"page_size": 1,
"result": {
"id": "0000",
"comment": "操作成功"
},
"sign": "EEF9D1307107AC6B7D9242C283A427EF"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>merchant_settlementquery_response</response_type>
<isspid>00058307</isspid>
<pos_seq>2022112500001</pos_seq>
<trans_time>20230324152353</trans_time>
<total>2</total>
<page_num>1</page_num>
<page_size>2</page_size>
<list>[]</list>
<result>
<id>0000</id>
<comment>操作成功</comment>
</result>
<sign>CAC0BA2826E985E7FD58C955975246B1</sign>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:merchant_settlementquery_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_seq | 终端流水号 | String(32) | 终端交易流水号和请求报文的交易流水相同 | 可选 |
trans_time | 交易时间 | String(14) | 交易时间,格式:yyyyMMddHHmmss | 必填 |
list | 结算记录 | Array | 结算记录 | 可选 |
list ->trans_id | 结算流水编号 | String | 结算流水编号 | 可选 |
list ->merchant_id | 用户id | String | 用户id | 可选 |
list ->trans_date | 结算日期 | String | 结算日期 | 可选 |
list ->settle_cycle | 结算方式 | String | 结算方式 | 可选 |
list ->card_no | 银行卡号(掩码) | String | 银行卡号(掩码) | 可选 |
list ->card_name | 银行户名 | String | 银行户名 | 可选 |
list ->bank_code | 银行编码 | String | 银行编码 | 可选 |
list ->trans_amt | 结算金额(分) | Number | 结算金额(分) | 可选 |
list ->fee_amt | 结算手续费(分) | Number | 结算手续费(分) | 可选 |
list ->trans_stat | 结算状态, | String | s=成功, p=处理中, f=失败 | 可选 |
list ->settle_type | 结算类型 | String | 0=对公结算, 1=对私法人结算, 2=对私非法人结算, 3=虚拟账户结算 | 可选 |
list ->merchant_id | 用户id | String | 商户id | 可选 |
result ->id | 响应码 | String(4) | 翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!