交易请求报文

JSON:

  1. {
  2. "request_type": "pos_info_request",
  3. "isspid": "39493002",
  4. "transaction_id": "20160823000001",
  5. "system_id": "8888",
  6. "auth_code": "111111",
  7. "sign": "B973E02223C49798CDCBCEE48FC323EF"
  8. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>pos_info_request</request_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>20160823000001</transaction_id>
  6. <system_id>8888</system_id>
  7. <auth_code>111111</auth_code>
  8. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)标识请求报文的类型,固定为pos_info_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码提供的商户号必填
transaction_id请求流水号String(32)方便查询日志定位必填
auth_code授权码String需要查询绑定结果及信息的授权码必填

交易返回报文

JSON:

  1. {
  2. "response_type": "pos_info_response",
  3. "isspid": "39493002",
  4. "transaction_id": "20160823000001",
  5. "auth_code": "111111",
  6. "dev_sn": "222222",
  7. "pos_name": "被绑定的设备的备注名称",
  8. "result": {
  9. "id": "0000",
  10. "comment": "设备绑定成功"
  11. },
  12. "sign": "EADFE430D0E856CF5F818690155F1258"
  13. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>pos_info_response</response_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>20160823000001</transaction_id>
  6. <auth_code>111111</auth_code>
  7. <dev_sn>222222</dev_sn>
  8. <pos_name>被绑定的设备的备注名称</pos_name>
  9. <result>
  10. <id>0000</id>
  11. <comment>设备绑定成功</comment>
  12. </result>
  13. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)标识返回报文的类型,固定为pos_info_response必填
isspid商户号String(8)翼码商户号必填
transaction_id请求流水号String(32)方便查询日志定位必填
auth_code授权码String需要查询绑定结果及信息的授权码必填
dev_sn设备SN号String绑定成功时必填
设备SN号,用于后续推送消息至该设备的唯一识别ID
该SN与绑定的POS机背后的的SN号一致
可空
pos_name被绑定的设备的备注名称String绑定成功时必填可空
result
->id
响应码String(4)0000-设备绑定成功
9998-设备绑定中,请稍后查询
其它表示失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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