交易请求报文

JSON:

  1. {
  2. "request_type": "electronic_receipt_request",
  3. "isspid": "39493002",
  4. "req_seq": "2018121400000005",
  5. "system_id": "8888",
  6. "electronic_receipt_request": {
  7. "org_pos_seq": "2018121400000001"
  8. },
  9. "sign": "79CB18BC49A4D60C457506EA4EF27C14"
  10. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>electronic_receipt_request</request_type>
  4. <isspid>39493002</isspid>
  5. <req_seq>1511300000003</req_seq>
  6. <system_id>8888</system_id>
  7. <electronic_receipt_request>
  8. <org_pos_seq>1511300000001</org_pos_seq>
  9. </electronic_receipt_request>
  10. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:electronic_receipt_request必填
isspid商户号String(8)翼码商户号,由翼码提供必填
req_seq申请流水号String(32)若传入要求同一个商户下不重复,且大于12位
可以选填
可选
system_id系统平台号String(4)由翼码提供必填
electronic_receipt_request
->org_pos_seq
需要查询的交易流水号String(32)需要查询的支付交易流水号,且大于12位必填
electronic_receipt_request
->fee_flag
手续费显示标识String(32)0=不显示(默认), 1=显示可选
electronic_receipt_request
->template_type
模板类型String(32)1=订单模板, 2=金额模板可选
electronic_receipt_request
->div_flag
电子回单类型String(32)1:分账模式电子回单,0:非分账模式电子回单,模板类型为“金额模板”才可以使用分账可选

交易返回报文

JSON:

  1. {
  2. "response_type": "electronic_receipt_response",
  3. "isspid": "39493002",
  4. "req_seq": "2018121400000005",
  5. "trans_time": "20181214143957",
  6. "sys_seq": "0f041092d0ccc6ae",
  7. "download_url": "http://www.baidu.com/xxxx.pdf",
  8. "view_url": "http://www.baidu.com/xxxx.pdf",
  9. "result": {
  10. "id": "0000",
  11. "comment": "交易成功"
  12. },
  13. "sign": "79D928004531AE15DFA6AD7E9A6A2447"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>electronic_receipt_response</response_type>
  4. <isspid>39493002</isspid>
  5. <req_seq>000000000001</req_seq>
  6. <sys_seq>000000000244</sys_seq>
  7. <trans_time>20090405010104</trans_time>
  8. <download_url>http://www.baidu.com/xxxx.pdf</download_url>
  9. <view_url>http://www.baidu.com/xxxx.pdf</view_url>
  10. <result>
  11. <id>0000</id>
  12. <comment>成功</comment>
  13. </result>
  14. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:electronic_receipt_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
req_seq申请流水号String(32)申请流水号,和请求报文相同可选
sys_seq随机串号String(16)随机生成串号,仅用于日志跟踪用,不保存必填
trans_time接口返回时间String(14)接口返回时间,格式:yyyyMMddHHmmss必填
download_url下载地址String下载地址, code为0000时存在可选
view_url预览地址String预览地址, code为0000时可能存在可选
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填