交易请求报文

JSON:

  1. {
  2.     "request_type": "bcm_resultquery_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "8888888888",
  5.     "store_id": "8888888888",
  6.     "pos_seq": "2018121400000005",
  7.     "user_id": "user01",
  8.     "system_id": "8888",
  9.     "bcm_resultquery_request": {
  10.         "org_pos_seq": "2018121400000001",
  11.         "pos_sn": "xxxxxxxxxx"
  12.     },
  13.     "sign": "79CB18BC49A4D60C457506EA4EF27C14"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>bcm_resultquery_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>1511300001</pos_id>
  6.     <store_id>1511300001</store_id>
  7.     <pos_seq>1511300000003</pos_seq>
  8.     <user_id>user01</user_id>
  9.     <system_id>8888</system_id>
  10.     <bcm_resultquery_request>
  11.         <org_pos_seq>1511300000001</org_pos_seq>
  12.         <pos_sn>xxxxxxxx</pos_sn>
  13.     </bcm_resultquery_request>
  14. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)标识请求报文的类型，固定为bcm_resultquery_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_resultquery_request->org_pos_seq需要查询的支付交易流水号String(32)需要查询的支付交易流水号，且大于12位
创建订单时的终端流水号		必填
bcm_resultquery_request->pos_snPOS机身号String(20)需要推送到的POS机身号必填

交易返回报文

JSON:

  1. {
  2.     "response_type": "bcm_resultquery_response",
  3.     "isspid": "39493002",
  4.     "pos_id": "8888888888",
  5.     "pos_seq": "2018121400000005",
  6.     "trans_time": "20181214143957",
  7.     "sys_seq": "0f041092d0ccc6ae",
  8.     "bcm_res_info": {
  9.         "order_id": "1805040000021",
  10.         "mid": "301310070118940",
  11.         "tid": "99800010",
  12.         "batch_no": "000001",
  13.         "trace_no": "000001",
  14.         "ref_no": "000523823884",
  15.         "card_no": "622262*********9671",
  16.         "trade_amount": "1",
  17.         "trade_time": "20190808151515",
  18.         "channel": "4"
  19.     },
  20.     "result": {
  21.         "id": "0000",
  22.         "comment": "交易成功"
  23.     },
  24.     "sign": "79D928004531AE15DFA6AD7E9A6A2447"
  25. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>bcm_resultquery_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>123456789</pos_id>
  6.     <pos_seq>000000000001</pos_seq>
  7.     <sys_seq>000000000244</sys_seq>
  8.     <trans_time>20090405010104</trans_time>
  9.     <bcm_res_info>
  10.         <order_id>1805040000021</order_id>
  11.         <mid>301310070118940</mid>
  12.         <tid>99800010</tid>
  13.         <batch_no>000001</batch_no>
  14.         <trace_no>000001</trace_no>
  15.         <ref_no>000523823884</ref_no>
  16.         <card_no>622262*********9671</card_no>
  17.         <trade_amount>1</trade_amount>
  18.         <trade_time>20190808151515</trade_time>
  19.         <channel>4</channel>
  20.     </bcm_res_info>
  21.     <result>
  22.         <id>0000</id>
  23.         <comment>成功</comment>
  24.     </result>
  25. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)标识返回报文的类型，固定为bcm_resultquery_response必填
isspid商户号String(8)接入SP的ID号，为翼码平台的提供的业务商机构号必填
pos_id终端号String(20)终端号必填
pos_seq终端流水号String(32)终端交易流水号，和请求报文中的交易流水号相同必填
sys_seq随机串号String(16)随机生成串号，仅用于日志跟踪用，不保存必填
trans_time接口返回时间String(14)接口返回时间，格式：yyyyMMddHHmmss必填
result
->id		响应码String(4)0000-成功
9998-等待付款
9990-交易失败
其它失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填
bcm_res_info
->order_id		银行卡订单号String(64)刷卡通道返回的订单号可空
bcm_res_info
->mid		银联商户号String(64)可空
bcm_res_info
->tid		银联设备号String(8)可空
bcm_res_info
->batch_no		银联批次号String(20)可空
bcm_res_info
->trace_no		银联流水号String(20)可空
bcm_res_info
->ref_no		银联交易参考号String(20)可空
bcm_res_info
->card_no		交易卡号String(20)前6后4明文，中间隐藏可空
bcm_res_info
->trade_amount		交易金额String(16)以分为单位可空
bcm_res_info
->trade_time		系统交易时间String(14)支付宝、微信等平台交易时间,例如：20190808151515可空
bcm_res_info
->channel		交易通道String(1)-：POS尚未拉取订单，通道未知
3：交行POS
4：星POS(翼码APP)		可空

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