e码通电子凭证服务平台通用接口接入规范

《e码通电子凭证服务平台通用接口接入规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、0b990863753a2138d1e8822f139ac1f4.docE码通电子凭证服务平台通用接口接入规范V1.0文档变更记录版本日期变更内容操作者备注V1.02011-05-05创建Bill初始版本V1.012011-06-02增加下属机构码Bill完善调整V1.022011-06-16增加短/彩信内容验证码放置位置控制Bill消息内容调整V1.032011-06-22生成凭证请求增加可选参数Bill参数调整-28-0b990863753a2138d1e8822f139ac1f4.doc目录1．前言41．1接口定义41．2术语定义4

2、2．接口协议52．1协议规定52．2请求参数约定52．3回调参数定义（生成结果列表）62．4流水号验证62．5时间戳验证62．6签名验证63．接口处理流程74．消息定义74.1商品提交请求84.1.1商品提交请求消息84.1.2商品提交返回结果94.2凭证的生成和分发(无商品号)94.2.1生成和分发请求消息104.2.2生成请求返回结果114.2.3回调消息124.3凭证的生成(不分发)134.3.1生成请求消息134.3.2生成请求返回结果14-28-0b990863753a2138d1e8822f139ac1f4.doc4.3.3回

3、调消息144.4凭证的生成和分发(有商品号)154.4.1生成和分发请求消息154.4.2短信和彩信内容构造规则164.4.3生成请求返回结果184.4.4回调消息184.5凭证使用查询194．5．1凭证使用查询消息194．5．2凭证使用查询结果204.6凭证的转发224.6.1转发请求消息224.6.2转发请求结果234.7凭证的重发234.7.1凭证重发请求234.7.2重发请求返回结果244.8凭证的废除244.8.1凭证废除请求244.8.2废除请求返回结果254.9账单查询254．9．1账单查询消息254．9．2账单查询结果26

4、4.10通知消息284.10.1消息头28-28-0b990863753a2138d1e8822f139ac1f4.doc4.10.2消息体285.结果提示定义29-28-0b990863753a2138d1e8822f139ac1f4.doc1．前言E码通电子凭证服务平台通用接口（以下简称通用接口或接口），是电子凭证服务平台为广大用户或商家提供的通用API，为用户使用平台的服务，进行电子凭证的生成、分发和验证提供便利。1．1接口定义接口是指由用户系统发起请求，平台对请求的消息进行处理，并将处理结果返回给用户系统的API程序。接口的返回类

5、型有两种形式，一种是同步的返回方式，一般如凭证查询、账单查询等使用这种方式，即查询的结果跟请求结果一起返回。另一种是异步的方式，如各种凭证的生成请求，请求的返回结果只是提示此次请求的成功与否，生成的执行结果将以回调或文件下载的方式，提供给用户系统——请求者。如果需要以回调的方式取回生成结果，必须提供有效的回调地址。1．2术语定义术语意义终端验证二维码的POS机回调由平台以异步方式向请求者发送请求的执行结果-28-0b990863753a2138d1e8822f139ac1f4.doc1．接口协议2．1协议规定接口通讯协议统一使用HTTP协

6、议，字符集使用UTF-8，请求方法使用POST。请求接口地址：正式环境调用地址：http://tb.ematong.com/gcert/submsg2．2请求参数约定序号参数参考值意义备注1methodrequestmessage消息方法2formatjson消息体格式或xml3version1.0版本4appkey1234567890123456商家的key5message{"request_message":{"message":{"req_type":"01","num_iid":"1011234578","title":"面包",

7、"price":1.20","mms_pic":"http://www.com.cn/image/g1234.jpg","descs":"商品描述","server_print_text":"终端打印的服务内容","detail_url":"http://www.com.cn/goods.htm"}}}消息体内容6flowno100000001请求流水号7timestamp2011-04-2008:50:15时间戳8sign7E65B60DCFA42B043FCF57169867082C数字签名注：请求接口的method的值固定为：req

8、uestmessage-28-0b990863753a2138d1e8822f139ac1f4.doc2．3回调参数定义（生成结果列表）序号参数参考值意义备注1methodcallbackme