交易请求报文

JSON:

  1. {
  2. "request_type": "barcode_bill_request",
  3. "isspid": "39493002",
  4. "transaction_id": "20160823000001",
  5. "system_id": "8888",
  6. "barcode_bill_request": {
  7. "partner_id": "2088************",
  8. "bill_type": "502",
  9. "bill_date": "20181210"
  10. },
  11. "sign": "D44704388A5D41EEF68FAF6DE8970103"
  12. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>barcode_bill_request</request_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>20160823000001</transaction_id>
  6. <system_id>8888</system_id>
  7. <barcode_bill_request>
  8. <partner_id>1111111111</partner_id>
  9. <bill_type>502</bill_type>
  10. <bill_date>20160823</bill_date>
  11. </barcode_bill_request>
  12. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:barcode_bill_request必填
isspid商户号String(8)翼码商户号,由翼码提供必填
transaction_id请求流水号String可空,用于日志定位可空
system_id系统平台号String(4)由翼码提供必填
barcode_bill_request
->partner_id
平台商户号String支付平台的商户号
当bill_type=601/602/603时该节点传值与isspid相同
必填
barcode_bill_request
->bill_type
账单类型String(3)502:支付宝
503:微信支付
515:微信小程序
601:现金退款
602:旺财合并对账单
603:分账文件
必填
barcode_bill_request
->bill_date
账单日期String(8)账单日期,必须小于当前日期
最大支持下载三个自然月的对账文件
必填

交易返回报文

JSON:

  1. {
  2. "request_type": "barcode_bill_response",
  3. "isspid": "39493002",
  4. "transaction_id": "2016011111111",
  5. "bill_type": "503",
  6. "partner_id": "2088************",
  7. "download_url_pt": "http://www.baidu.com/aaa.csv",
  8. "download_url_ym": "http://www.baidu.com/aaa.csv",
  9. "result": {
  10. "id": "0000",
  11. "comment": "交易成功"
  12. },
  13. "sign": "5E0CC3B6E80825D5692B914681614455"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>barcode_bill_response</response_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>2016011111111</transaction_id>
  6. <bill_type>503</bill_type>
  7. <partner_id>1219548001</partner_id>
  8. <download_url_pt>[下载地址]</download_url_pt>
  9. <download_url_ym>[下载地址]</download_url_ym>
  10. <result>
  11. <id>0000</id>
  12. <comment>交易成功</comment>
  13. </result>
  14. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:barcode_bill_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
transaction_id请求流水号String可空,用于日志定位可空
bill_type账单类型String(3)502:支付宝
503:微信支付
515:微信小程序
601:现金退款
602:旺财合并对账单
603:分账文件
必填
partner_id平台商户号String支付平台的商户号
当bill_type=601/602/603时该节点传值与isspid相同
必填
download_url_pt平台账单String支付平台的明细账单下载url
当bill_type=601/602/603时没有平台账单
可空
download_url_ym翼码账单String翼码平台的明细账单下载url必填
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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