业务说明

目前仅支持通联通道的交易，每日结算文件的下载。

交易请求报文

JSON:

  1. {
  2.     "request_type": "barcode_settle_request",
  3.     "isspid": "39493002",
  4.     "transaction_id": "20160823000001",
  5.     "system_id": "8888",
  6.     "settle_date": "20240612",
  7.     "sign": "D44704388A5D41EEF68FAF6DE8970103"
  8. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>barcode_settle_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <transaction_id>20160823000001</transaction_id>
  6.     <system_id>8888</system_id>
  7.     <settle_date>20240612</settle_date>
  8. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：barcode_settle_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
transaction_id请求流水号String可空，用于日志定位可空
system_id系统平台号String(4)由翼码提供必填
settle_date结算日期String(8)最大支持下载三个自然月的对账文件必填

交易返回报文

JSON:

  1. {
  2.     "request_type": "barcode_settle_response",
  3.     "isspid": "39493002",
  4.     "transaction_id": "20160823000001",
  5.     "settle_date": "20240612",
  6.     "download_url": "https://ipos-sa-std.wangcaio2o.com/data_link/20240612/20240612_39493002_settle_c7ea31.csv",
  7.     "result": {
  8.         "id": "0000",
  9.         "comment": "获取成功"
  10.     },
  11.     "sign": "5E0CC3B6E80825D5692B914681614455"
  12. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>barcode_settle_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <transaction_id>20160823000001</transaction_id>
  6.     <settle_date>20240612</settle_date>
  7.     <download_url><![CDATA[https://ipos-sa-std.wangcaio2o.com/data_link/20240612/20240612_39493002_settle_c7ea31.csv]]></download_url>
  8.     <result>
  9.         <id>0000</id>
  10.         <comment>获取成功</comment>
  11.     </result>
  12. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：barcode_settle_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
transaction_id请求流水号String与请求相同可空
settle_date结算日期String(8)与请求相同可空
download_url下载地址String结算文件的下载地址
使用XML格式报文时，将使用CDATA标签包裹内容		可空
result
->id		响应码String(4)0000-获取成功
其它表示失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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