交易请求报文

JSON:

  1. {
  2.     "request_type": "bcm_refund_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "8888888888",
  5.     "store_id": "8888888888",
  6.     "pos_seq": "2018121400000006",
  7.     "user_id": "user01",
  8.     "system_id": "8888",
  9.     "memo": "订单备注",
  10.     "bcm_refund_request": {
  11.         "tx_amt": "1",
  12.         "org_pos_seq": "2018121400000001",
  13.         "pos_sn": "",
  14.         "terminal_id": "0001045907",
  15.         "notify_url": "http://www.baidu.com/"
  16.     },
  17.     "sign": "E622B688C360F8444788740B111E4787"
  18. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>bcm_refund_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>1511300001</pos_id>
  6.     <store_id>1511300001</store_id>
  7.     <pos_seq>1511300000004</pos_seq>
  8.     <user_id>user01</user_id>
  9.     <system_id>8888</system_id>
  10.     <memo>订单备注</memo>
  11.     <bcm_refund_request>
  12.         <tx_amt>10</tx_amt>
  13.         <org_pos_seq>1511300000001</org_pos_seq>
  14.         <pos_sn></pos_sn>
  15.         <terminal_id>0001045907</terminal_id>
  16.         <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
  17.     </bcm_refund_request>
  18. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：bcm_refund_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
store_id门店号String(20)商户自定义门店号必填
pos_seq退款请求流水号String(32)同一个翼码商户号下唯一，不可重复使用，且大于12位必填
user_id操作员标识String(20)操作员号可空
system_id系统平台号String(4)由翼码提供必填
memo订单备注String(128)可空
bcm_refund_request
->tx_amt		退款金额Number(9)退款金额，单位为分，不支持小数点。
说明：部分通道银行卡交易仅支持全额退款，不支持部分退款，具体退款规则请咨询联调支持人员。		必填
bcm_refund_request
->org_pos_seq		支付请求流水号String(32)被退款的支付请求流水号，且大于12位必填
bcm_refund_request
->pos_sn		刷卡POS机身号String(20)订单推送的刷卡POS设备的机身号
说明：此节点只有在联机刷卡退款时有效，使用服务端接口退款传此节点无效。详细规则请咨询联调支持人员。		可空
bcm_refund_request
->terminal_id		刷卡POS终端号String(10)订单推送的刷卡POS设备的终端号
说明：此节点只有在联机刷卡退款时有效，使用服务端接口退款传此节点无效。详细规则请咨询联调支持人员。		可空
bcm_refund_request
->notify_url		异步通知地址String(256)异步通知文档见4.20
使用XML格式报文时，建议使用CDATA标签包裹内容
退款结果通知仅支持部分通道		可空

关于订单推送设备的特别说明

刷卡POS机身号(pos_sn) 和 刷卡POS终端号(terminal_id)
两个节点只有在联机刷卡退款时有效，使用服务端接口退款传此节点无效
两个节点对应不同版本的刷卡设备APP使用，不可同时使用
详细规则请咨询联调支持人员

交易返回报文

JSON:

  1. {
  2.     "response_type": "bcm_refund_response",
  3.     "system_id": "8888",
  4.     "isspid": "39493002",
  5.     "pos_id": "8888888888",
  6.     "pos_seq": "2018121400000006",
  7.     "trans_time": "20181214145332",
  8.     "sys_seq": "b7ff9fa5bb4355e2",
  9.     "result": {
  10.         "id": "9998",
  11.         "comment": "申请成功"
  12.     },
  13.     "sign": "207482F2C0A998B73F388B8AA401DB76"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>bcm_refund_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.     <result>
  10.         <id>0000</id>
  11.         <comment>交易成功</comment>
  12.     </result>
  13. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：bcm_refund_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
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)响应码对应中文注解，用于显示提示必填

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