交易请求报文
JSON:
{
"request_type": "bcm_orderquery_request",
"isspid": "39493002",
"system_id": "8888",
"user_id": "user01",
"timestamp": "2019-04-01 02:00:00",
"tid": "99800010",
"order_id": "11111111111111111111",
"channel": "4",
"sign": "79CB18BC49A4D60C457506EA4EF27C14"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>bcm_orderquery_request</request_type>
<isspid>39493002</isspid>
<system_id>8888</system_id>
<user_id>user01</user_id>
<timestamp>2019-08-08 15:15:15</timestamp>
<tid>99800010</tid>
<order_id>11111111111111111111</order_id>
<channel>4</channel>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:bcm_orderquery_request | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
user_id | 操作员标识 | String(20) | 操作员号 | 可空 |
timestamp | 请求时间 | String(19) | 发送请求的时间,格式“yyyy-MM-dd HH:mm:ss” | 必填 |
tid | 银联设备号 | String(8) | 银联设备号 | 可空 |
order_id | 订单编号 | String(32) | 大于12位小于32位 二维码扫码得到的内容 | 必填 |
channel | 交易通道 | String(1) | 3:交行POS 4:星POS(翼码APP) 5:通联 传空,默认为3 | 可空 |
交易返回报文
JSON:
{
"response_type": "bcm_orderquery_response",
"isspid": "39493002",
"trans_time": "20181214143957",
"sys_seq": "0f041092d0ccc6ae",
"order_id": "11111111111111111111",
"order_info": null,
"order_type": "1",
"trade_amount": "1",
"trade_time": "20181214143957",
"status_trans": "1",
"status_msg": "该订单已支付成功",
"goods_detail": [
{
"goods_name": "啊ipad",
"quantity": 1,
"price": 200000
},
{
"goods_name": "额ipad2",
"quantity": 1,
"price": 200000
}
],
"result": {
"id": "0000",
"comment": "查询成功"
},
"sign": "79D928004531AE15DFA6AD7E9A6A2447"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>bcm_orderquery_response</response_type>
<isspid>39493002</isspid>
<sys_seq>000000000244</sys_seq>
<trans_time>20090405010104</trans_time>
<order_id>11111111111111111111</order_id>
<order_info></order_info>
<order_type>1</order_type>
<trade_amount>1</trade_amount>
<trade_time>20090405010104</trade_time>
<status_trans>1</status_trans>
<status_msg>该订单已支付成功</status_msg>
<goods_detail>
<![CDATA[[
{
"goods_name": "啊ipad",
"quantity": 1,
"price": 200000
},
{
"goods_name": "额ipad2",
"quantity": 1,
"price": 200000
}
]]]>
</goods_detail>
<result>
<id>0000</id>
<comment>查询成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:bcm_orderquery_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
result ->id | 响应码 | String(4) | 0000-查询成功 9990-查询失败 其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
order_id | 订单编号 | String(32) | 商户创建订单终端流水号 | 必填 |
order_info | 订单附加信息 | String | 暂不启用 | 可空 |
order_type | 订单类型 | String(1) | 1:消费订单 2:退款订单 查询成功时返回不为空 | 可空 |
trade_amount | 订单金额 | String(16) | 以分为单位 查询成功时返回不为空 | 可空 |
goods_detail | 商品信息 | JSONArray | 商品明细列表 详细参数见下表 | 可空 |
trade_time | 交易完成时间 | String(14) | 交易完成时间,格式:yyyyMMddHHmmss | 可空 |
status_trans | 交易状态 | String(1) | 0:失败 1:成功 2:撤销 3:退款 4:待付款 5:部分退款 6:预授权确认 交易状态 | 可空 |
status_msg | 交易状态描述 | String(64) | 交易状态描述 | 可空 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
goods_detail 商品信息 (JSONArray)
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
goods_name | String(256) | 商品名称 | 必填 | ipad |
quantity | Number(9) | 商品数量 | 必填 | 1 |
price | Number(8) | 商品单价,单位为分 | 必填 | 200000 |
goods_detail 样例:
[
{
"goods_name": "啊ipad",
"quantity": 1,
"price": 200000
},
{
"goods_name": "额ipad2",
"quantity": 1,
"price": 200000
}
]