统一下单
应用场景
商户在小程序中先调用该接口在微信支付服务后台生成预支付交易单返回正确的预支付交易后调起支付。
接口链接
URL地址：https://api.mch.weixin.qq.com/pay/unifiedorder
是否需要证书
否
请求参数
字段名
变量名
必填
类型
示例值
描述
商品简单描述该字段须严格按照规范传递具体请见参数规定 商品详细列表使用Json格式传输签名前请务必使用CDATA标签将JSON文本串保护起来。 goods_detail []：
小程序ID
appid
是
String(32)
wxd678efh567hg6787
微信分配的小程序ID
商户号
mch_id
是
String(32)
1230000109
微信支付分配的商户号
设备号
device_info
否
String(32)
013467007045764
终端设备号(门店号或收银设备ID)注意：PC网页或公众号内支付请传"WEB"
随机字符串
nonce_str
是
String(32)
5K8264ILTKCH16CQ2502SI8ZNMTM67VS
随机字符串搜索引擎友好注意：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":"苹果手机"
}
]
}
└ goods_id String 必填 32 商品的编号
└ wxpay_goods_id String 可选 32 微信支付定义的统一商品编号
└ goods_name String 必填 256 商品名称
└ quantity Int 必填 商品数量
└ price Int 必填 商品单价单位为分
└ goods_category String 可选 32 商品类目ID
└ body String 可选 1000 商品描述信息
附加数据
attach
否
String(127)
深圳分店
附加数据在查询API和支付通知中原样返回该字段主要用于商户携带订单的自定义数据
商户订单号
out_trade_no
是
String(32)
20150806125346
商户系统内部的订单号,32个字符内、可包含字母, 其他说明见商户订单号
货币类型
fee_type
否
String(16)
CNY
符合ISO 4217标准的三位字母代码默认人民币：CNY其他值列表详见货币类型
总金额
total_fee
是
Int
888
订单总金额单位为分详见支付金额
终端IP
spbill_create_ip
是
String(16)
123.12.12.123
APP和网页支付提交用户端ipNative支付填调用微信支付API的机器IP。
交易起始时间
time_start
否
String(14)
20091225091010
订单生成时间格式为yyyyMMddHHmmss如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则
交易结束时间
time_expire
否
String(14)
20091227091010