业务说明
目前仅支持通联通道的交易,每日结算文件的下载。
交易请求报文
JSON:
{
"request_type": "barcode_settle_request",
"isspid": "39493002",
"transaction_id": "20160823000001",
"system_id": "8888",
"settle_date": "20240612",
"sign": "D44704388A5D41EEF68FAF6DE8970103"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>barcode_settle_request</request_type>
<isspid>39493002</isspid>
<transaction_id>20160823000001</transaction_id>
<system_id>8888</system_id>
<settle_date>20240612</settle_date>
</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:
{
"request_type": "barcode_settle_response",
"isspid": "39493002",
"transaction_id": "20160823000001",
"settle_date": "20240612",
"download_url": "https://ipos-sa-std.wangcaio2o.com/data_link/20240612/20240612_39493002_settle_c7ea31.csv",
"result": {
"id": "0000",
"comment": "获取成功"
},
"sign": "5E0CC3B6E80825D5692B914681614455"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>barcode_settle_response</response_type>
<isspid>39493002</isspid>
<transaction_id>20160823000001</transaction_id>
<settle_date>20240612</settle_date>
<download_url><![CDATA[https://ipos-sa-std.wangcaio2o.com/data_link/20240612/20240612_39493002_settle_c7ea31.csv]]></download_url>
<result>
<id>0000</id>
<comment>获取成功</comment>
</result>
</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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!