交易请求报文
JSON:
{
"request_type": "barcode_mqueryorder_request",
"isspid": "39493002",
"pos_id": "6666666666",
"store_id": "6666666666",
"pos_seq": "2018121400000021",
"user_id": "user01",
"system_id": "8888",
"barcode_mqueryorder_request": {
"trans_date": "20181214"
},
"sign": "2EB4051F33C84719D59E0F5EADACF5D2"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>barcode_mqueryorder_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000003</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<barcode_mqueryorder_request>
<trans_date>20160823</trans_date>
</barcode_mqueryorder_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:barcode_mqueryorder_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_mqueryorder_request ->trans_date | 交易日期 | String(8) | 交易日期,格式:yyyymmdd | 必填 |
交易返回报文
JSON:
{
"response_type": "barcode_mqueryorder_response",
"isspid": "39493002",
"pos_id": "1511300001",
"pos_seq": "1511300000005",
"trans_date": "20160823",
"extend": "<![CDATA[]]>",
"trans_list": [
{
"trans_type": "1",
"trans_time": "20160823151010",
"pos_seq": "1511300000003",
"pay_type": "502",
"status": "1",
"tx_amt": 1000,
"buss_discount_amt": 2,
"platform_discount_amt": 2,
"org_pos_seq": "",
"memo": "订单备注",
"fund_freeze_stat": ""
},
{
"trans_type": "2",
"trans_time": "20160823152010",
"pos_seq": "1511300000004",
"pay_type": "502",
"status": "0",
"tx_amt": 1000,
"buss_discount_amt": 0,
"platform_discount_amt": 0,
"org_pos_seq": "1511300000003",
"memo": "",
"fund_freeze_stat": ""
}
],
"result": {
"id": "0000",
"comment": "交易成功"
},
"sign": "824FE953936278AEE61CA8CEE8A08C86"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>barcode_mqueryorder_response</response_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<pos_seq>1511300000005</pos_seq>
<trans_date>20160823</trans_date>
<extend><![CDATA[扩展字段(json格式)]]></extend>
<trans_list>
<trans_row>
<trans_type>1</trans_type>
<trans_time>20160823151010</trans_time>
<pos_seq>1511300000003</pos_seq>
<pay_type>502</pay_type>
<status>1</status>
<tx_amt>1000</tx_amt>
<buss_discount_amt>2</buss_discount_amt>
<platform_discount_amt>2</platform_discount_amt>
<org_pos_seq></org_pos_seq>
<memo>订单备注</memo>
<fund_freeze_stat></fund_freeze_stat>
</trans_row>
<trans_row>
<trans_type>2</trans_type>
<trans_time>20160823152010</trans_time>
<pos_seq>1511300000004</pos_seq>
<pay_type>502</pay_type>
<status>0</status>
<tx_amt>1000</tx_amt>
<buss_discount_amt>0</buss_discount_amt>
<platform_discount_amt>0</platform_discount_amt>
<org_pos_seq>1511300000003</org_pos_seq>
<memo></memo>
<fund_freeze_stat></fund_freeze_stat>
</trans_row>
</trans_list>
<result>
<id>0000</id>
<comment>交易成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:barcode_mqueryorder_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
pos_seq | 查询请求流水号 | String(32) | 查询请求流水号,和请求报文相同 | 可选 |
trans_date | 交易日期 | String(8) | 交易日期,格式:yyyymmdd | 必填 |
extend | 扩展信息 | String | 扩展信息字段内容为json格式 预留字段后续业务扩展使用 | 可空 |
result ->id | 响应码 | String(4) | 翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
trans_list 交易流水列表 | ||||
trans_row 每条流水子节点JSON格式没有trans_row节点,子节点直接并列组成trans_list,参考交易返回报文 | ||||
trans_type | 交易类型 | String(1) | 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:成功 6:等待付款/退款处理中 1:已退款 (仅支付交易类型) a:部分退款 (仅支付交易类型) 8:未付款已撤销 (仅支付交易类型) 3:失败 | 必填 |
tx_amt | 交易金额 | String(16) | 交易金额,单位为分,不支持小数点 | 必填 |
buss_discount_amt | 商家优惠金额 | String(16) | 商家优惠金额,单位为分 | 可空 |
platform_discount_amt | 平台优惠金额 | String(16) | 平台优惠金额,单位为分 | 可空 |
org_pos_seq | 支付请求流水号 | String(32) | 被退款的支付请求流水号 | 可空 |
memo | 订单备注 | String(128) | 返回支付请求时内容 | 可空 |
fund_freeze_stat | 资金冻结状态 | String(2) | 01:冻结 02:解冻 空表示无此类业务 支付交易表示当前的资金冻结状态 退款交易表示退款发生时的原支付交易资金冻结状态 | 可空 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!