交易请求报文
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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!


