交易请求报文

JSON:

  1. {
  2.     "request_type": "bcm_ordercreate_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "1511300001",
  5.     "store_id": "1511300001",
  6.     "pos_seq": "2018121400000004",
  7.     "user_id": "user01",
  8.     "system_id": "8888",
  9.     "bcm_ordercreate_request": {
  10.         "pos_sn": "N9NL0000001",
  11.         "tx_amt": "1",
  12.         "extend_params": null
  13.     },
  14.     "sign": "314DA43E7E244105ECBD45F797264854"
  15. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>bcm_ordercreate_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>1511300001</pos_id>
  6.     <store_id>1511300001</store_id>
  7.     <pos_seq>1511300000002</pos_seq>
  8.     <user_id>user01</user_id>
  9.     <system_id>8888</system_id>
  10.     <bcm_ordercreate_request>
  11.         <pos_sn>N9NL0000001</pos_sn>
  12.         <tx_amt>1</tx_amt>
  13.         <extend_params></extend_params>
  14.         <goods_detail><![CDATA[
  15.             [
  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.     </bcm_ordercreate_request>
  29. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)标识请求报文的类型，固定为bcm_ordercreate_request必填
isspid商户号String(8)接入SP的ID号，由翼码平台分配给ipos接入受理商户的机构号（原值返回）必填
pos_id终端号String(20)终端号必填
store_id门店号String(20)门店号必填
pos_seq终端流水号String(32)同一个商户必须唯一，且大于12位必填
user_id操作员标识String(20)操作员号可空
system_id系统平台号String(4)由翼码提供必填
bcm_ordercreate_request
->pos_sn		POS机身号String(20)需要推送到的POS机身号
不传则不推送，使用二维码方式传递订单信息		必填
bcm_ordercreate_request
->tx_amt		订单金额Number(9)订单金额，单位为分，不支持小数点必填
bcm_ordercreate_request
->extend_params		扩展参数String用于扩展字段，暂不启用可空

交易返回报文

JSON:

  1. {
  2.     "response_type": "bcm_ordercreate_response",
  3.     "isspid": "39493002",
  4.     "pos_id": "6666666666",
  5.     "pos_seq": "2018121400000004",
  6.     "trans_time": "20181214143516",
  7.     "sys_seq": "0741136885a748c1",
  8.     "result": {
  9.         "id": "9998",
  10.         "comment": "创建订单成功"
  11.     },
  12.     "sign": "F6106656C20AB23B547B0C30DD819793"
  13. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>bcm_ordercreate_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>1511300001</pos_id>
  6.     <pos_seq>1511300000002</pos_seq>
  7.     <sys_seq>0311095321465179</sys_seq>
  8.     <trans_time>20160311095321</trans_time>
  9.     <result>
  10.         <id>9998</id>
  11.         <comment>创建订单成功</comment>
  12.     </result>
  13. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)标识返回报文的类型，固定为bcm_ordercreate_response必填
isspid商户号String(8)接入SP的ID号，为翼码平台的提供的业务商机构号必填
pos_id终端号String(20)终端号必填
pos_seq终端流水号String(32)终端交易流水号，和请求报文中的交易流水号相同
创建订单成功(id=9998)之后，将该字段作为二维码内容生成，使用POS扫码		必填
sys_seq随机串号String(16)随机生成串号，仅用于日志跟踪用，不保存必填
trans_time接口返回时间String(14)接口返回时间，格式：yyyyMMddHHmmss必填
result
->id		响应码String(4)银行卡刷卡下单时返回 9998 表示创建订单成功，进入轮询调用银行卡刷卡查询接口确认交易结果
其它失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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