交易请求报文
JSON:
{
"request_type": "pos_authcode_request",
"isspid": "39493002",
"transaction_id": "20160823000001",
"system_id": "8888",
"pos_name": "被绑定的设备的备注名称",
"sign": "B973E02223C49798CDCBCEE48FC323EF"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>pos_authcode_request</request_type>
<isspid>39493002</isspid>
<transaction_id>20160823000001</transaction_id>
<system_id>8888</system_id>
<pos_name>被绑定的设备的备注名称</pos_name>
</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:
{
"response_type": "pos_authcode_response",
"isspid": "39493002",
"transaction_id": "20160823000001",
"auth_code": "111111",
"result": {
"id": "0000",
"comment": "成功"
},
"sign": "EADFE430D0E856CF5F818690155F1258"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>pos_authcode_response</response_type>
<isspid>39493002</isspid>
<transaction_id>20160823000001</transaction_id>
<auth_code>111111</auth_code>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
</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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!