交易请求报文

JSON:

  1. {
  2.     "request_type": "barcode_queryorder_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "8888888888",
  5.     "store_id": "8888888888",
  6.     "pos_seq": "2018121400000022",
  7.     "user_id": "user01",
  8.     "system_id": "8888",
  9.     "barcode_queryorder_request": {
  10.         "org_pos_seq": "2018121400000001"
  11.     },
  12.     "sign": "A7E60EACBAB7DD32A6FF4BC941234933"
  13. }

XML:

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

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：barcode_queryorder_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)由翼码提供必填
barcode_queryorder_request
->org_pos_seq		支付请求流水号String(32)被查询的支付请求流水号，且大于12位必填

交易返回报文

JSON:

  1. {
  2.     "response_type": "barcode_queryorder_response",
  3.     "isspid": "39493002",
  4.     "pos_id": "1511300001",
  5.     "pos_seq": "1511300000010",
  6.     "extend": "<![CDATA[]]>",
  7.     "order_info": {
  8.         "trans_type": "1",
  9.         "trans_time": "20160823151010",
  10.         "pos_seq": "1511300000006",
  11.         "pay_type": "502",
  12.         "status": "1",
  13.         "tx_amt": 1000,
  14.         "buss_discount_amt": 2,
  15.         "platform_discount_amt": 2,
  16.         "memo": "订单备注",
  17.         "fund_freeze_stat": "",
  18.         "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}"
  19.     },
  20.     "reverse_list": [
  21.         {
  22.             "trans_type": "2",
  23.             "trans_time": "20160823152010",
  24.             "pos_seq": "1511300000007",
  25.             "pay_type": "502",
  26.             "status": "0",
  27.             "tx_amt": 500,
  28.             "org_pos_seq": "1511300000006",
  29.             "fund_freeze_stat": "",
  30.             "fee_allowance_info": "{\"receivable_ref_fee_amt\":\"2\",\"actual_ref_fee_amt\":\"1\",\"allowance_ref_fee_amt\":\"1\"}"
  31.         },
  32.         {
  33.             "trans_type": "2",
  34.             "trans_time": "20160823153010",
  35.             "pos_seq": "1511300000008",
  36.             "pay_type": "502",
  37.             "status": "0",
  38.             "tx_amt": 500,
  39.             "org_pos_seq": "1511300000006",
  40.             "fund_freeze_stat": "",
  41.             "fee_allowance_info": "{\"receivable_ref_fee_amt\":\"2\",\"actual_ref_fee_amt\":\"1\",\"allowance_ref_fee_amt\":\"1\"}"
  42.         }
  43.     ],
  44.     "result": {
  45.         "id": "0000",
  46.         "comment": "交易成功"
  47.     },
  48.     "sign": "FE1263A8A77F8DF257CE1755E4FD500E"
  49. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>barcode_queryorder_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>1511300001</pos_id>
  6.     <pos_seq>1511300000010</pos_seq>
  7.     <extend><![CDATA[扩展字段(json格式)]]></extend>
  8.     <order_info>
  9.         <trans_type>1</trans_type>
  10.         <trans_time>20160823151010</trans_time>
  11.         <pos_seq>1511300000006</pos_seq>
  12.         <pay_type>502</pay_type>
  13.         <status>1</status>
  14.         <tx_amt>1000</tx_amt>
  15.         <buss_discount_amt>2</buss_discount_amt>
  16.         <platform_discount_amt>2</platform_discount_amt>
  17.         <memo>订单备注</memo>
  18.         <fund_freeze_stat></fund_freeze_stat>
  19.         <fee_allowance_info><![CDATA[{"receivable_fee_amt":"2","actual_fee_amt":"1","allowance_fee_amt":"1"}]]></fee_allowance_info>
  20.     </order_info>
  21.     <reverse_list>
  22.         <reverse_row>
  23.             <trans_type>2</trans_type>
  24.             <trans_time>20160823152010</trans_time>
  25.             <pos_seq>1511300000007</pos_seq>
  26.             <pay_type>502</pay_type>
  27.             <status>0</status>
  28.             <tx_amt>500</tx_amt>
  29.             <org_pos_seq>1511300000006</org_pos_seq>
  30.             <fund_freeze_stat></fund_freeze_stat>
  31.             <fee_allowance_info><![CDATA[{"receivable_ref_fee_amt":"2","actual_ref_fee_amt":"1","allowance_ref_fee_amt":"1"}]]></fee_allowance_info>
  32.         </reverse_row>
  33.         <reverse_row>
  34.             <trans_type>2</trans_type>
  35.             <trans_time>20160823153010</trans_time>
  36.             <pos_seq>1511300000008</pos_seq>
  37.             <pay_type>502</pay_type>
  38.             <status>0</status>
  39.             <tx_amt>500</tx_amt>
  40.             <org_pos_seq>1511300000006</org_pos_seq>
  41.             <fund_freeze_stat></fund_freeze_stat>
  42.             <fee_allowance_info><![CDATA[{"receivable_ref_fee_amt":"2","actual_ref_fee_amt":"1","allowance_ref_fee_amt":"1"}]]></fee_allowance_info>
  43.         </reverse_row>
  44.     </reverse_list>
  45.     <result>
  46.         <id>0000</id>
  47.         <comment>交易成功</comment>
  48.     </result>
  49. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：barcode_queryorder_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq查询请求流水号String(32)查询请求流水号，和请求报文相同可选
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用		可空
result
->id		响应码String(4)翼码平台返回的处理结果,0000-成功，其它失败，错误信息说明见“响应码解释”字段必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填
order_info
->trans_type		交易类型String(1)1：支付必填
order_info
->trans_time		交易时间String(14)交易时间，格式：yyyyMMddHHmmss必填
order_info
->pos_seq		支付请求流水号String(32)必填
order_info
->pay_type		支付类型String(3)502：支付宝
503：微信支付
515：微信小程序
512：银联二维码
516：数字人民币
517：网银支付
518：快捷支付
519：会员余额支付
521：聚分期		必填
order_info
->status		交易状态String(1)0：成功
6：等待付款
1：已退款 (仅支付交易类型)
a：部分退款 (仅支付交易类型)
8：未付款已撤销 (仅支付交易类型)
3：失败		必填
order_info
->tx_amt		交易金额String(16)交易金额，单位为分，不支持小数点必填
order_info
->buss_discount_amt		商家优惠金额String(16)商家优惠金额，单位为分可空
order_info
->platform_discount_amt		平台优惠金额String(16)平台优惠金额，单位为分可空
order_info
->memo		订单备注String(128)返回支付请求时内容可空
order_info
->fund_freeze_stat		资金冻结状态String(2)01：冻结
02：解冻
空表示无此类业务		可空
fee_allowance_info手续费补贴信息StringJSONString格式，仅支持汇付通道交易
详细参数见下表		可空
reverse_list退款流水列表若无退款信息节点为空
reverse_row每条流水子节点，JSON格式没有reverse_row节点，子节点直接并列组成reverse_list参考交易返回报文
trans_type交易类型String(1)2：退款必填
trans_time交易时间String(14)交易时间，格式：yyyyMMddHHmmss必填
pos_seq退款请求流水号String(32)必填
pay_type支付类型String(3)502：支付宝
503：微信支付
515：微信小程序
512：银联二维码
516：数字人民币
517：网银支付
518：快捷支付
519：会员余额支付
521：聚分期		必填
status交易状态String(1)0：成功
3：失败
6：退款处理中		必填
tx_amt交易金额String(16)交易金额，单位为分，不支持小数点必填
org_pos_seq支付请求流水号String(28)被退款的支付请求流水号可空
fund_freeze_stat资金冻结状态String(2)退款发生时，对应原支付交易的资金冻结状态
01：冻结
02：解冻
空表示无此类业务		可空
fee_allowance_info手续费补贴返还信息StringJSONString格式，仅支持汇付通道交易
详细参数见下表		可空

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

fee_allowance_info 手续费补贴信息 (JSONString) (交易类型：支付)

JSON节点类型说明是否必填范例
receivable_fee_amtString商户应收手续费，单位：分必填2
actual_fee_amtString商户实收手续费，单位：分必填1
allowance_fee_amtString补贴手续费，单位：分必填1
allowance_typeString补贴类型
0：不补贴，为空默认
1：补贴
2：部分补贴
3：全额补贴(优惠后)
4：部分补贴(优惠后)		必填2
no_allowance_descString不补贴原因
1：汇收款产品(HSK)银联二维码交易金额大于1000元不补贴
2：额度用完
3：不在有效期
4：活动不存在
5：手续费金额为0不补贴
6：顶格优惠
7：额度不足
8：手续费后补
9：未达到起始补贴金额		可空2
cur_allowance_config_infosJSONObject手续费补贴活动详情，详细参数见下表可空　

cur_allowance_config_infos 手续费补贴活动详情 (JSONObject) (交易类型：支付)

JSON节点类型说明是否必填范例
merchant_groupString商户号，通道侧商户号可空6666000123120000
acct_idString门店可空sh002
activity_idString活动号必填223402342
activity_nameString活动描述可空开业大促
statusString活动是否有效
1：生效
0：失效		必填1
total_limit_amtString活动总补贴额度，单位：分必填1000
start_timeString活动开始时间，yyyyMMdd必填20220909
end_timeString活动结束时间，yyyyMMdd必填20220911
human_flagString是否人工操作
N：自动
Y：人工		必填1
allowance_sysString补贴方
1：银行
2：服务商
3：汇来米		必填1
allowance_sys_idString补贴方ID，通道侧商户号必填6666000123120000
is_delay_allowanceString补贴类型
1：实补
2：后补
默认实补		必填1
is_shareString是不是共享额度可空
market_idString自定义活动编号必填ISFE00232
market_nameString自定义活动名称可空开业大促
market_descString自定义活动描述可空新店开业大促
pos_credit_limit_amtStringpos贷记卡补贴额度，单位：分必填500
pos_debit_limit_amtStringpos借记卡补贴额度，单位：分必填200
pos_limit_amtStringpos补贴额度，单位：分必填400
qr_limit_amtString扫码补贴额度，单位：分必填100
create_byString创建人必填Lg2022022201394910571
create_timeString创建时间必填2022-04-14 22:00:30
update_timeString更新时间必填2022-04-14 23:00:30

fee_allowance_info 手续费补贴返还信息 (JSONString) (交易类型：退款)

JSON节点类型说明是否必填范例
receivable_ref_fee_amtString退款返还总手续费，单位：分必填2
actual_ref_fee_amtString退款返还商户手续费，单位：分必填1
allowance_ref_fee_amtString退款返还补贴手续费，单位：分必填1