交易请求报文
JSON:
{
"request_type": "bcm_ordercreate_request",
"isspid": "39493002",
"pos_id": "1511300001",
"store_id": "1511300001",
"pos_seq": "2018121400000004",
"user_id": "user01",
"system_id": "8888",
"bcm_ordercreate_request": {
"pos_sn": "N9NL0000001",
"tx_amt": "1",
"extend_params": null
},
"sign": "314DA43E7E244105ECBD45F797264854"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>bcm_ordercreate_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000002</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<bcm_ordercreate_request>
<pos_sn>N9NL0000001</pos_sn>
<tx_amt>1</tx_amt>
<extend_params></extend_params>
<goods_detail><![CDATA[
[
{
"goods_name": "啊ipad",
"quantity": 1,
"price": 200000
},
{
"goods_name": "额ipad2",
"quantity": 1,
"price": 200000
}
]
]]></goods_detail>
</bcm_ordercreate_request>
</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:
{
"response_type": "bcm_ordercreate_response",
"isspid": "39493002",
"pos_id": "6666666666",
"pos_seq": "2018121400000004",
"trans_time": "20181214143516",
"sys_seq": "0741136885a748c1",
"result": {
"id": "9998",
"comment": "创建订单成功"
},
"sign": "F6106656C20AB23B547B0C30DD819793"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>bcm_ordercreate_response</response_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<pos_seq>1511300000002</pos_seq>
<sys_seq>0311095321465179</sys_seq>
<trans_time>20160311095321</trans_time>
<result>
<id>9998</id>
<comment>创建订单成功</comment>
</result>
</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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!