交易请求报文

JSON:

  1. {
  2. "request_type": "pos_authcode_request",
  3. "isspid": "39493002",
  4. "transaction_id": "20160823000001",
  5. "system_id": "8888",
  6. "pos_name": "被绑定的设备的备注名称",
  7. "sign": "B973E02223C49798CDCBCEE48FC323EF"
  8. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>pos_authcode_request</request_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>20160823000001</transaction_id>
  6. <system_id>8888</system_id>
  7. <pos_name>被绑定的设备的备注名称</pos_name>
  8. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)标识请求报文的类型,固定为pos_authcode_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码提供的商户号必填
transaction_id请求流水号String(32)方便查询日志定位必填
pos_name被绑定的设备的备注名称String用于绑定多个设备时人工区分(可用贴纸贴在设备上快速区分)必填

交易返回报文

JSON:

  1. {
  2. "response_type": "pos_authcode_response",
  3. "isspid": "39493002",
  4. "transaction_id": "20160823000001",
  5. "auth_code": "111111",
  6. "result": {
  7. "id": "0000",
  8. "comment": "成功"
  9. },
  10. "sign": "EADFE430D0E856CF5F818690155F1258"
  11. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>pos_authcode_response</response_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>20160823000001</transaction_id>
  6. <auth_code>111111</auth_code>
  7. <result>
  8. <id>0000</id>
  9. <comment>成功</comment>
  10. </result>
  11. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)标识返回报文的类型,固定为pos_authcode_response必填
isspid商户号String(8)翼码商户号必填
transaction_id请求流水号String(32)方便查询日志定位必填
auth_code授权码String交易成功时必填
生成二维码后在 POS 机上的 IOT 服务应用中扫码输入
或者在 POS 机上的 IOT 服务应用中手工输入
可空
result
->id
响应码String(4)0000-成功
其它表示失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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