交易请求报文

JSON:

  1. {
  2. "request_type": "bcm_orderquery_request",
  3. "isspid": "39493002",
  4. "system_id": "8888",
  5. "user_id": "user01",
  6. "timestamp": "2019-04-01 02:00:00",
  7. "tid": "99800010",
  8. "order_id": "11111111111111111111",
  9. "channel": "4",
  10. "sign": "79CB18BC49A4D60C457506EA4EF27C14"
  11. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>bcm_orderquery_request</request_type>
  4. <isspid>39493002</isspid>
  5. <system_id>8888</system_id>
  6. <user_id>user01</user_id>
  7. <timestamp>2019-08-08 15:15:15</timestamp>
  8. <tid>99800010</tid>
  9. <order_id>11111111111111111111</order_id>
  10. <channel>4</channel>
  11. </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:

  1. {
  2. "response_type": "bcm_orderquery_response",
  3. "isspid": "39493002",
  4. "trans_time": "20181214143957",
  5. "sys_seq": "0f041092d0ccc6ae",
  6. "order_id": "11111111111111111111",
  7. "order_info": null,
  8. "order_type": "1",
  9. "trade_amount": "1",
  10. "trade_time": "20181214143957",
  11. "status_trans": "1",
  12. "status_msg": "该订单已支付成功",
  13. "goods_detail": [
  14. {
  15. "goods_name": "啊ipad",
  16. "quantity": 1,
  17. "price": 200000
  18. },
  19. {
  20. "goods_name": "额ipad2",
  21. "quantity": 1,
  22. "price": 200000
  23. }
  24. ],
  25. "result": {
  26. "id": "0000",
  27. "comment": "查询成功"
  28. },
  29. "sign": "79D928004531AE15DFA6AD7E9A6A2447"
  30. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>bcm_orderquery_response</response_type>
  4. <isspid>39493002</isspid>
  5. <sys_seq>000000000244</sys_seq>
  6. <trans_time>20090405010104</trans_time>
  7. <order_id>11111111111111111111</order_id>
  8. <order_info></order_info>
  9. <order_type>1</order_type>
  10. <trade_amount>1</trade_amount>
  11. <trade_time>20090405010104</trade_time>
  12. <status_trans>1</status_trans>
  13. <status_msg>该订单已支付成功</status_msg>
  14. <goods_detail>
  15. <![CDATA[[
  16. {
  17. "goods_name": "啊ipad",
  18. "quantity": 1,
  19. "price": 200000
  20. },
  21. {
  22. "goods_name": "额ipad2",
  23. "quantity": 1,
  24. "price": 200000
  25. }
  26. ]]]>
  27. </goods_detail>
  28. <result>
  29. <id>0000</id>
  30. <comment>查询成功</comment>
  31. </result>
  32. </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_nameString(256)商品名称必填ipad
quantityNumber(9)商品数量必填1
priceNumber(8)商品单价,单位为分必填200000

goods_detail 样例:

  1. [
  2. {
  3. "goods_name": "啊ipad",
  4. "quantity": 1,
  5. "price": 200000
  6. },
  7. {
  8. "goods_name": "额ipad2",
  9. "quantity": 1,
  10. "price": 200000
  11. }
  12. ]