CloudPay.unifiedOrder()

支持端：云函数 2.0.2

微信支付统一下单

说明

商户在小程序中先挪用该接口在微信支付服务后台天生预支付生意单，，，返回准确的预支付生意后调起支付。。。。。

要害参数说明

云开发相关要害参数说明： 回调函数设置：envId 和 functionName 用来设置吸收支付后的异步通知回调的云函数 返回字段 payment：该工具即是在小程序端挪用 wx.requestPayment 所需的信息

回调云函数返回协议

支付效果回调的云函数必需返回如下一个工具，，，否则会视为回调不乐成，，，云函数会收到重复的支付回调：

字段名变量名必填类型形貌

过失码errcode是Number0

过失信息errmsg是String

参数说明

字段名变量名必填类型示例值形貌

效果通知回调云函数名functionName是Stringpaycallback吸收微信支付异步通知回调的云函数名

效果通知回调云函数情形envId是Stringtest-123吸收微信支付异步通知回调的云函数所在的情形 ID

子商户号subMchId是String(32)1900000109微信支付分配的子商户号

装备号deviceInfo否String(32)013467007045764终端装备号(门店号或收银装备ID)，，，注重：PC网页或公众号内支付请传"WEB"

随机字符串nonceStr是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，，，不长于32位。。。。。推荐随机数天生算法

商品形貌body是String(128)腾讯充值中心-QQ会员充值商品简朴形貌，，，该字段须严酷凭证规范转达，，，详细请见参数划定

商品详情detail否String(6000)商品详细形貌，，，关于使用单品优惠的商户，，，该字段必需凭证规范上传，，，详见“单品优惠参数说明”

附加数据attach否String(127)说明附加数据，，，在盘问API和支付通知中原样返回，，，该字段主要用于商户携带订单的自界说数据

商户订单号outTradeNo是String(32)1217752501201407033233368018商户系统内部订单号，，，要求32个字符内，，，只能是数字、巨细写字母_-

钱币类型feeType否String(16)CNY切合ISO 4217标准的三位字母代码，，，默认人民币：CNY，，，其他值列表详见钱币类型

总金额totalFee是Int888订单总金额，，，只能为整数，，，详见支付金额

终端IPspbillCreateIp是String(64)123.12.12.123支持IPV4和IPV6两种名堂的IP地点。。。。。挪用微信支付API的机械IP

生意起始时间timeStart否String(14)20091225091010订单天生时间，，，名堂为yyyyMMddHHmmss，，，如2009年12月25日9点10分10秒体现为20091225091010。。。。。其他详见时间规则

生意竣事时间timeExpire否String(14)20091227091010订单失效时间，，，名堂为yyyyMMddHHmmss，，，如2009年12月27日9点10分10秒体现为20091227091010。。。。。订单失效时间是针对订单号而言的，，，由于在请求支付的时间有一个必传参数prepay_id只有两小时的有用期，，，以是在重入时间凌驾2小时的时间需要重新请求下单接口获取新的prepay_id。。。。。其他详见时间规则。。。。。

建议：最短失效时间距离大于1分钟

订单优惠标记goodsTag否String(32)WXG订单优惠标记，，，代金券或立减优惠功效的参数，，，说明详见代金券或立减优惠

生意类型tradeType是String(16)JSAPI小程序取值如下：JSAPI，，，详细说明见参数划定

指定支付方式limitPay否String(32)no_creditno_credit--指定不可使用信用卡支付

用户标识openid否String(128)oUpF8uMuAJO_M2pxb1Q9zNjWeS6otrade_type=JSAPI，，，此参数必传，，，用户在商户appid下的唯一标识。。。。。openid怎样获取，，，可参考【获取openid】。。。。。

用户子标识subOpenid否String(128)oUpF8uMuAJO_M2pxb1Q9zNjWeS6otrade_type=JSAPI，，，此参数必传，，，用户在子商户appid下的唯一标识。。。。。openid和sub_openid可以选传其中之一，，，若是选择传sub_openid,则必需传sub_appid。。。。。下单前需要挪用【网页授权获取用户信息】接口获取到用户的Openid。。。。。

电子发票入口开放标识receipt否String(8)YY，，，传入Y时，，，支付乐成新闻和支付详情页将泛起开票入口。。。。。需要在微信支付商户平台或微信公众平台开通电子发票功效，，，传此字段才可生效

场景信息sceneInfo否String(256)Y该字段常用于线下活动时的场景信息上报，，，支持上报现实门店信息，，，商户也可以按需求自己上报相关信息。。。。。该字段为JSON工具数据，，，工签字堂为{"store_info":{"id": "门店ID","name": "名称","area_code": "编码","address": "地点" }}

sceneInfo.storeInfo 工具说明*

字段名变量名必填类型示例值形貌

门店idid否String(32)SZTX001门店编号，，，由商户自界说

门店名称name否String(64)腾讯大厦腾大餐厅门店名称 ，，，由商户自界说

门店行政区划码area_code否String(6)440305门店所在地行政区划码，，，详细见《最新县及县以上行政区划代码》

门店详细地点address否String(128)科技园中一起腾讯大厦门店详细地点 ，，，由商户自界说

返回值说明

字段名变量名必填类型示例值形貌

返回状态码returnCode是String(16)SUCCESSSUCCESS/FAIL 此字段是通讯标识，，，非生意标识，，，生意是否乐成需要审查result_code来判断

返回信息returnMsg否String(128)署名失败返回信息，，，如非空，，，为过失原因。。。。。如 署名失败、参数名堂校验过失

以下字段在returnCode为SUCCESS的时间有返回

字段名变量名必填类型示例值形貌

小程序中提倡支付所需信息payment是Object小程序端挪用 wx.requestPayment 所需信息

服务商的APPIDappid是String(32)wxd678efh567hg6787服务商商户的APPID

商户号mch_id是String(32)1900000109挪用接口提交的商户号

小程序的APPIDsub_appid是String(32)wx8888888888888888微信分配的小程序ID

子商户号sub_mch_id是String(32)1900000109微信支付分配的子商户号

装备号device_info否String(32)013467007045764挪用接口提交的终端装备号，，，

随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS微信返回的随机字符串

署名sign是String(64)C380BEC2BFD727A4B6845133519F3AD6微信返回的署名，，，详见署名算法

营业效果result_code是String(16)SUCCESSSUCCESS/FAIL

过失代码err_code否String(32)SYSTEMERROR详细拜见第6节过失列表

过失代码形貌err_code_des否String(128)系统过失过失返回的信息形貌

以下字段在returnCode 和result_code都为SUCCESS的时间有返回

字段名变量名必填类型示例值形貌

生意类型trade_type是String(16)JSAPI挪用接口提交的生意类型，，，取值如下：JSAPI，，，详细说明见参数划定

预支付生意会话标识prepay_id是String(64)wx201410272009395522657a690389285100微信天生的预支付回话标识，，，用于后续接口挪用中使用，，，该值有用期为2小时

二维码链接code_url否String(64)weixin://wxpay/bizpayurl/up?pr=NwY5Mz9&groupid=00trade_type=NATIVE时有返回，，，此url用于天生支付二维码，，，然后提供应用户举行扫码支付。。。。。注重：code_url的值并非牢靠，，，使用时凭证URL名堂转成二维码即可

过失码

名称形貌原因解决方案

INVALID_REQUEST参数过失参数名堂有误或者未按规则上传订单重入时，，，要求参数值与原请求一致，，，请确认参数问题

NOAUTH商户无此接口权限商户未开通此接口权限请商户前往申请此接口权限

NOTENOUGH余额缺乏用户帐号余额缺乏用户帐号余额缺乏，，，请用户充值或替换支付卡后再支付

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

ORDERCLOSED订单已关闭目今订单已关闭，，，无法支付目今订单已关闭，，，请重新下单

SYSTEMERROR系统过失系统超时系统异常，，，请用相同参数重新挪用

APPID_NOT_EXISTAPPID不保存参数中缺少APPID请检查APPID是否准确

MCHID_NOT_EXISTMCHID不保存参数中缺少MCHID请检查MCHID是否准确

APPID_MCHID_NOT_MATCHappid和mch_id不匹配appid和mch_id不匹配请确认appid和mch_id是否匹配

LACK_PARAMS缺少参数缺少须要的请求参数请检查参数是否齐全

OUT_TRADE_NO_USED商户订单号重复统一笔生意不可多次提交请核实商户订单号是否重复提交

SIGNERROR署名过失参数署名效果不准确请检查署名参数和要领是否都切合署名算法要求

XML_FORMAT_ERRORXML名堂过失XML名堂过失请检查XML参数名堂是否准确

REQUIRE_POST_METHOD请使用post要领未使用post转达参数请检查请求参数是否通过post要领提交

POST_DATA_EMPTYpost数据为空post数据不可为空请检查post数据是否为空

NOT_UTF8编码名堂过失未使用指定编码名堂请使用UTF-8编码名堂

示例代码

// 云函数代码

const cloud = require('wx-server-sdk')

cloud.init({

env: cloud.DYNAMIC_CURRENT_ENV

})

exports.main = async (event, context) => {

const res = await cloud.cloudPay.unifiedOrder({

"body" : "小秋TIT店-超市",

"outTradeNo" : "1217752501201407033233368018",

"spbillCreateIp" : "127.0.0.1",

"subMchId" : "1900009231",

"totalFee" : 1,

"envId": "test-f0b102",

"functionName": "pay_cb"

})

return res

}

// 小程序代码

wx.cloud.callFunction({

name: '函数名',

data: {

// ...

},

success: res => {

const payment = res.result.payment

wx.requestPayment({

...payment,

success (res) {

console.log('pay success', res)

},

fail (res) {

console.error('pay fail', err)

}

})

},

fail: console.error,

})