258资源分享网

统一下单

应用场景

商户在小程序中先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易后调起支付。

接口链接

URL地址：https://api.mch.weixin.qq.com/pay/unifiedorder

是否需要证书

否

请求参数

字段名 变量名 必填 类型 示例值 描述
小程序ID   appid   是   String(32)   wxd678efh567hg6787   微信分配的小程序ID  
商户号   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":"苹果手机"
}
]
}  

商品详细列表，使用Json格式，传输签名前请务必使用CDATA标签将JSON文本串保护起来。

goods_detail []：
└ 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和网页支付提交用户端ip，Native支付填调用微信支付API的机器IP。  
交易起始时间   time_start   否   String(14)   20091225091010   订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则  
交易结束时间   time_expire   否   String(14)   20091227091010