交易请求报文

JSON:

  1. {
  2. "request_type": "merchant_settlementquery_request",
  3. "isspid": "00058307",
  4. "pos_seq": "2022112500001",
  5. "system_id": "8888",
  6. "merchant_settlementquery_request": {
  7. "merchant_id": [
  8. 1001301,
  9. 1001301
  10. ],
  11. "begin_date": "2023-03-23",
  12. "end_date": "2023-03-23",
  13. "page_size": 10,
  14. "page_num": 1
  15. },
  16. "sign": "712036C2324D76F2934C44C95A80CEBA"
  17. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>merchant_settlementquery_request</request_type>
  4. <isspid>00058301</isspid>
  5. <pos_seq>2022112500001</pos_seq>
  6. <system_id>8888</system_id>
  7. <merchant_settlementquery_request>
  8. <merchant_id>[]</merchant_id>
  9. <begin_date>2023-03-23</begin_date>
  10. <end_date>2023-03-23</end_date>
  11. <page_size>10</page_size>
  12. <page_num>1</page_num>
  13. </merchant_settlementquery_request>
  14. </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
分账商户idArray分账商户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:

  1. {
  2. "response_type": "merchant_settlementquery_response",
  3. "isspid": "00058307",
  4. "pos_seq": "2022112500001",
  5. "trans_time": "20230324142833",
  6. "list": [
  7. {
  8. "trans_id": "1000485308838536",
  9. "merchant_id": "1000200",
  10. "trans_date": "20230323",
  11. "trans_amount": 1,
  12. "fee_amount": 0,
  13. "fee_amount_yuan": "0.00",
  14. "settle_cycle": "T1",
  15. "settle_type": "1",
  16. "card_no": "621700*********9289",
  17. "card_name": "陈xx",
  18. "bank_code": "01050000",
  19. "trans_stat": "s"
  20. }
  21. ],
  22. "total": 1,
  23. "page_num": 1,
  24. "page_size": 1,
  25. "result": {
  26. "id": "0000",
  27. "comment": "操作成功"
  28. },
  29. "sign": "EEF9D1307107AC6B7D9242C283A427EF"
  30. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>merchant_settlementquery_response</response_type>
  4. <isspid>00058307</isspid>
  5. <pos_seq>2022112500001</pos_seq>
  6. <trans_time>20230324152353</trans_time>
  7. <total>2</total>
  8. <page_num>1</page_num>
  9. <page_size>2</page_size>
  10. <list>[]</list>
  11. <result>
  12. <id>0000</id>
  13. <comment>操作成功</comment>
  14. </result>
  15. <sign>CAC0BA2826E985E7FD58C955975246B1</sign>
  16. </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
用户idString用户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
结算状态,Strings=成功, p=处理中, f=失败可选
list
->settle_type
结算类型String0=对公结算, 1=对私法人结算, 2=对私非法人结算, 3=虚拟账户结算可选
list
->merchant_id
用户idString商户id可选
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!