交易保障

服务商的APPID

appid

是

String(32)

wx8888888888888888

服务商商户的APPID

商户号

mch_id

是

String(32)

1900000109

微信支付分配的商户号

子商户公众账号ID

sub_appid

否

String(32)

wx8888888888888888

微信分配的子商户公众账号ID

子商户号

sub_mch_id

是

String(32)

1900000109

微信支付分配的子商户号

设备号

device_info

否

String(32)

013467007045764

微信支付分配的终端设备号，商户自定义

随机字符串

nonce_str

是

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

随机字符串，不长于32位。推荐随机数生成算法

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名，详见签名生成算法

接口URL

interface_url

是

String(127)

https://api.mch.weixin.qq.com/pay/unifiedorder

上报对应的接口的完整URL，类似：

https://api.mch.weixin.qq.com/pay/unifiedorder

对于刷卡支付，为更好的和商户共同分析一次业务行为的整体耗时情况，对于两种接入模式，请都在门店侧对一次刷卡行为进行一次单独的整体上报，上报URL指定为：

https://api.mch.weixin.qq.com/pay/micropay/total

关于两种接入模式具体可参考本文档章节：刷卡支付商户接入模式

其它接口调用仍然按照调用一次，上报一次来进行。

上报数据包

trades

是

String(1024)

[
[
    {
        "out_trade_no": "out_trade_no_test_1",
        "begin_time": "20160602203256",
        "end_time": "20160602203257",
        "state": "OK",
        "err_msg": ""
    },
    {
        "out_trade_no": "out_trade_no_test_2",
        "begin_time": "20160602203260",
        "end_time": "20160602203262",
        "state": "FAIL",
        "err_msg": "SYSTEMERROR"
    }
]
]

POS机采集的交易信息列表，使用JSON格式的数组，每条交易包含：

1. out_trade_no 商户订单号

2. begin_time 交易开始时间（扫码时间）

3. end_time 交易完成时间

4. state 交易结果

                   OK   -成功 
                   FAIL -失败 
                   CANCLE-取消

1. err_msg 自定义的错误描述信息

*注意，将JSON数组的文本串放到XML节点中时，需要使用!CDATA[]标签将JSON文本串保护起来

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断

返回信息

return_msg

否

String(128)

签名失败

返回信息，如非空，为错误原因，例如：签名失败、参数格式校验错误

业务结果

result_code

是

String(16)

SUCCESS

SUCCESS/FAIL