统一下单

公众账号ID

appid

是

String(32)

wxd678efh567hg6787

微信分配的公众账号ID（企业号corpid即为此appid）

商户号

mch_id

是

String(32)

1230000109

微信支付分配的商户号

设备号

device_info

否

String(32)

013467007045764

终端设备号(门店号或收银设备ID)，注意：PC网页或公众号内支付请传"WEB"

随机字符串

nonce_str

是

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

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

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名，详见签名生成算法

签名类型

sign_type

否

String(32)

HMAC-SHA256

签名类型，目前支持HMAC-SHA256和MD5，默认为MD5

商品描述

body

是

String(128)

腾讯充值中心-QQ会员充值

商品简单描述，该字段须严格按照规范传递，具体请见参数规定

商品详情

detail

否

String(6000)

[{
"goods_detail":[
{
"goods_id":"iphone6s_16G",
"wxpay_goods_id":"1001",
"goods_name":"iPhone6s 16G",
"quantity":1,
"price":528800,
"goods_category":"123456",
"body":"苹果手机"
},
{
"goods_id":"iphone6s_32G",
"wxpay_goods_id":"1002",
"goods_name":"iPhone6s 32G",
"quantity":1,
"price":608800,
"goods_category":"123789",
"body":"苹果手机"
}
]
}]

单品优惠字段(暂未上线)

附加数据

attach

否

String(127)

深圳分店

附加数据，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据

商户订单号

out_trade_no

是

String(32)

20150806125346

商户系统内部订单号，要求32个字符内（最少6个字符），只能是数字、大小写字母_-|*且在同一个商户号下唯一。详见商户订单号

货币类型

fee_type

否

String(16)

CNY

符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型

总金额

total_fee

是

int

888

订单总金额，单位为分，详见支付金额

终端IP

spbill_create_ip

是

String(64)

123.12.12.123

必须传正确的用户端IP,支持ipv4、ipv6格式，获取方式详见获取用户ip指引

交易起始时间

time_start

否

String(14)

20091225091010

订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则

交易结束时间

time_expire

否

String(14)

20091227091010

订单失效时间，格式为yyyyMMddHHmmss，如2009年12月27日9点10分10秒表示为20091227091010。

商品标记

goods_tag

否

String(32)

WXG

商品标记，代金券或立减优惠功能的参数，说明详见代金券或立减优惠

通知地址

notify_url

是

String(256)

https://www.weixin.qq.com/wxpay/pay.php

接收微信支付异步通知回调地址，通知url必须为直接可访问的url，不能携带参数。

交易类型

trade_type

是

String(16)

MWEB

H5支付的交易类型为MWEB

商品ID

product_id

否

String(32)

12235413214070356458058

trade_type=NATIVE，此参数必传。此id为二维码中包含的商品ID，商户自行定义。

指定支付方式

limit_pay

否

String(32)

no_credit

no_credit--指定不能使用信用卡支付

用户标识

openid

否

String(128)

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

trade_type=JSAPI，此参数必传，用户在商户appid下的唯一标识。openid如何获取，可参考【获取openid】。企业号请使用【企业号OAuth2.0接口】获取企业号内成员userid，再调用【企业号userid转openid接口】进行转换

电子发票入口开放标识

receipt

否

String(8)

Y

Y，传入Y时，支付成功消息和支付详情页将出现开票入口。需要在微信支付商户平台或微信公众平台开通电子发票功能，传此字段才可生效

场景信息

scene_info

是

String(256)

//IOS移动应用
{"h5_info": {"type":"IOS","app_name": "王者荣耀","bundle_id": "com.tencent.wzryIOS"}}

//安卓移动应用
{"h5_info": {"type":"Android","app_name": "王者荣耀","package_name": "com.tencent.tmgp.sgame"}}

//WAP网站应用
{"h5_info": {"type":"Wap","wap_url": "https://pay.qq.com","wap_name": "腾讯充值"}}

//门店信息
{"store_info" : {
"id": "SZTX001",
"name": "腾大餐厅",
"area_code": "440305",
"address": "科技园中一路腾讯大厦" }}

该字段用于上报支付的场景信息,针对H5支付有以下三种场景,请根据对应场景上报,H5支付不建议在APP端使用，针对场景1，2请接入APP支付，不然可能会出现兼容性问题

1，IOS移动应用
{"h5_info": //h5支付固定传"h5_info"
    {"type": "",  //场景类型
     "app_name": "",  //应用名
     "bundle_id": ""  //bundle_id
     }
}

2，安卓移动应用
{"h5_info": //h5支付固定传"h5_info"
    {"type": "",  //场景类型
     "app_name": "",  //应用名
     "package_name": ""  //包名
     }
}

3，WAP网站应用
{"h5_info": //h5支付固定传"h5_info"
   {"type": "",  //场景类型
    "wap_url": "",//WAP网站URL地址
    "wap_name": ""  //WAP 网站名
    }
}

4，门店信息
{"store_info" : {
"id": "", //门店ID
"name": "", //门店名称
"area_code": "", //门店所在地行政区划码，详细见《最新县及县以上行政区划代码.csv》
"address": "" //门店地址 }}

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

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

返回信息

return_msg

是

String(128)

OK

当return_code为FAIL时返回信息为错误原因 ，例如: 签名失败、参数格式校验错误

公众账号ID

appid

是

String(32)

wx8888888888888888

调用接口提交的公众账号ID

商户号

mch_id

是

String(32)

1900000109

调用接口提交的商户号

设备号

device_info

否

String(32)

013467007045764

调用接口提交的终端设备号，

随机字符串

nonce_str

是

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

微信返回的随机字符串

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

微信返回的签名，详见签名算法

业务结果

result_code

是

String(16)

SUCCESS

SUCCESS/FAIL

错误代码

err_code

否

String(32)

SYSTEMERROR

详细参见错误列表

错误代码描述

err_code_des

否

String(128)

系统错误

错误返回的信息描述

交易类型

trade_type

是

String(16)

MWEB

调用接口提交的交易类型，取值如下：JSAPI，NATIVE，APP，,H5支付固定传MWEB

预支付交易会话标识

prepay_id

是

String(64)

wx201410272009395522657a690389285100

微信生成的预支付会话标识，用于后续接口调用中使用，该值有效期为2小时,针对H5支付此参数无特殊用途

支付跳转链接

mweb_url

是

String(64)

https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241

mweb_url为拉起微信支付收银台的中间页面，可通过访问该url来拉起微信客户端，完成支付,mweb_url的有效期为5分钟。

NOAUTH

商户无此接口权限

商户未开通此接口权限

请商户前往申请此接口权限

ORDERPAID

商户订单已支付

商户订单已支付，无需重复操作

商户订单已支付，无需更多操作

ORDERCLOSED

订单已关闭

当前订单已关闭，无法支付

当前订单已关闭，请重新下单

SYSTEMERROR

系统错误

系统超时

系统异常，请用相同参数重新调用

APPID_NOT_EXIST

APPID不存在

参数中缺少APPID

请检查APPID是否正确

MCHID_NOT_EXIST

MCHID不存在

参数中缺少MCHID

请检查MCHID是否正确

APPID_MCHID_NOT_MATCH

appid和mch_id不匹配

appid和mch_id不匹配

请确认appid和mch_id是否匹配

LACK_PARAMS

缺少参数

缺少必要的请求参数

请检查参数是否齐全

OUT_TRADE_NO_USED

商户订单号重复

同一笔交易不能多次提交

请核实商户订单号是否重复提交

SIGNERROR

签名错误

参数签名结果不正确

请检查签名参数和方法是否都符合签名算法要求

XML_FORMAT_ERROR

XML格式错误

XML格式错误

请检查XML参数格式是否正确

REQUIRE_POST_METHOD

请使用post方法

未使用post传递参数 

请检查请求参数是否通过post方法提交

POST_DATA_EMPTY

post数据为空

post数据不能为空

请检查post数据是否为空

NOT_UTF8

编码格式错误

未使用指定编码格式

请使用UTF-8编码格式