1、接口的请求和响应的报文：采用XML作为具体业务报文的载体
2、请求方式为：POST方式
3、传输时的charset需要设置为：GBK
4、传递数据报文格式如下：
请求：xml=请求报文的urlencode&mac=mac计算值。
应答：响应报文
5、MAC计算规则为：密钥+请求/应答报文+密钥 进行MD5加密。其中的密钥由翼码平台提供给各接入平台。
示例：
请求报文为：<?xml version="1.0" encoding="GBK" ?><a>123</a>
密钥为：654321
则通讯报文为：xml=urlencode(<?xml version="1.0" encoding="GBK" ?><a>123</a>)&mac=md5(654321<?xml version="1.0" encoding="GBK" ?><a>123</a>654321）

黄色部分为固定字串

红色部分为函数名称

绿色部分为请求报文

紫色部分为密钥

备注：请求报文中的中文需转换为GBK字符编码

xml参数报文格式如下：

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans version=“1.0”>
  3.     <request_type>request_type</request_type>
  4.     <pos_id>12345678</pos_id>
  5.     <pos_seq>000000000001</pos_seq>
  6.     <user_id>000001</user_id>
  7.     <request_type_name>
  8.         <field_tag1>field1</field_tag1>
  9.         ……
  10.     </request_type_name>
  11. </business_trans>

说明：

XML元素意义说明
encoding报文的字符集编码GBK
business_trans翼码平台交易标志，交易XML包的根标记，所有交易的内容必须位于此标注内version为本接口规范版本号
request_type交易类型，其值可能为：
query_request
barcode_pay_request
barcode_query_request
等，红色部分请求为request，响应为response
pos_seq终端交易流水号同一终端，终端流水号唯一
user_id终端操作员号

注：报文中灰色节点为可选节点，其它为必填节点。
由于返回报文可能增加元素，节点位置可能会发生变化，建议接收返回报文解析时按报文节点名称获取数据，而不要按照节点顺序获取。