Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

公众号支付下单

最新更新时间:2020.1.08 版本说明


通过本接口提交微信支付公众号支付订单


接口说明

适用对象:直连模式机构模式

请求URL: https://api.mch.weixin.qq.com/hk/v3/transactions/jsapi

请求方式: POST

接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3/wei-xin-zhi-fu-api-v3-jie-kou-gui-fan


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名 变量 类型 必填 描述
商户号 mchid string(32) body 微信支付分配的商户号
注意:仅适用于直连模式
示例值:1900000109
APPID appid string(32) body 商户在微信公众平台或开放平台生成的应用的APPID。求统一下单接口时请注意APPID的应用属性,例如公众号场景下,需使用应用属性为公众号的APPID。
注意:仅适用于直连模式
示例值:wx8888888888888888
子商户号 sub_mchid string(32) body 微信支付分配的子商户号
注意:仅适用于机构模式
示例值:1900000109
机构商户号 sp_mchid string(32) body 微信支付分配的机构商户号
注意:仅适用于机构模式
示例值:1900000100
机构APPID sp_appid string(32) body 机构在微信公众平台申请服务号对应的APPID
注意:仅适用于机构模式
示例值:wx8888888888888888
子商户APPID sub_appid string(32)

body 子商户在微信开放平台申请移动应用对应的APPID
付款码支付/扫码支付/公众号支付使用商户公众号appid
小程序支付使用商户小程序appid
APP支付使用商户APP应用appid
注意:仅适用于机构模式
示例值:wx8888888888888888

商品描述 description string(127) body 商品或支付单简要描述,格式要求:门店品牌名-城市分店名-实际商品名称
示例值:image形象店-深圳腾大- QQ公仔
商户数据 attach string(127) body 附加数据,在查询API和支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
示例值:自定义数据
通知地址 notify_url string(256) body 异步接收微信支付结果通知的回调地址,通知url必须为外网可访问的url,不能携带参数。请使用https协议链接
示例值:https://www.weixin.qq.com/wxpay/pay.php
商户订单号 out_trade_no string(32) body 商户系统内部的订单号,32个字符内、可包含字母;重新下单时请更换单号,其他说明见商户订单号
示例值:1217752501201407033233368018
商品标记 goods_tag string(32) body 商品标记
示例值:WXG
交易类型 trade_type string(16) body枚举值:
JSAPI:公众号支付
NATIVE:扫码支付
APP:App支付
MWEB:H5支付
MICROPAY:付款码支付
示例值:APP
指定支付方式 limit_pay string(32) body no_credit:指定不能使用信用卡支付
示例值:no_credit
交易起始时间 time_start string(64) body 订单生成时间,格式为rfc3339格式,如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒
示例值:2018-06-08T10:34:56+08:00
交易结束时间 time_expire string(64) body 订单失效时间,格式为rfc3339格式,如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒。
示例值:2018-06-08T10:34:56+08:00
MCC码 merchant_category_code string(16) body 商户行业编码,值列表详见商户行业编码
示例值:1011
+ 支付者 payer object body 支付者信息,详细说明见下文
参数名 变量 类型 必填 描述
用户标识 openid string(128) 用户在商户appid对应下的唯一标识,需要传appid才有返回 ,openid如何获取,可详见获取openid
注意:仅适用于直连模式
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用户标识(机构) sp_openid string(128) 用户在机构sp_appid对应下的唯一标识,openid和sub_openid可以选传其中之一,如果选择传sub_openid,则必须传sub_appid。下单前需要调用【网页授权】接口获取到用户的openid。
注意:仅适用于机构模式
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用户标识(特约商户) sub_openid string(128) 用户在子商户sub_appid下用户唯一标识,openid和sub_openid可以选传其中之一,如果选择传sub_openid,则必须传sub_appid。下单前需要调用【网页授权】接口获取到用户的openid,
注意:仅适用于机构模式
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+订单金额 amount object body 订单金额信息,详细说明见下文
参数名 变量 类型 必填 描述
总金额 total int 订单总金额,币种的最小单位,只能为整数,详见交易金额
示例值:888
货币类型 currency string(16) 符合ISO 4217标准的三位字母代码
注意:当前仅支持使用HKD标价
示例值:HKD
+ 场景信息 scene_info object body 场景信息对象,详细说明见下文
参数名 变量 类型 必填 描述
商户端设备号 device_id string(32) 终端设备号(商户自定义,如门店编号)
示例值:013467007045764
商户端设备IP device_ip string(40) 商户侧设备IP,取公网出口IP,支持IPV6
示例值:128.0.0.1
用户终端IP payer_client_ip string(40) 用户侧设备IP,取公网出口IP,支持IPV6
示例值:128.0.0.1
操作员ID operator_id string(32) 收银员ID,由商户自定义
示例值:123145
+ 商户门店信息 store_info object 门店信息对象,详细说明见下文
参数名 变量 类型 必填 描述
编号 id string(32) 商户侧门店ID
示例值:0001
名称 name string(32) 商户侧门店名称
示例值:腾讯大厦分店
详细地址 address string(64) 详细的商户门店地址
示例值:广东省深圳市南山区科技中一道10000号
+ 优惠功能 detail object body 优惠功能信息,详细说明见下文
参数名 变量 类型 必填 描述
订单原价 cost_price int 1.商户侧一张小票订单可能被分多次支付,订单原价用于记录整张小票的交易金额。
2.当订单原价与支付金额不相等,则不享受优惠。
3.该字段主要用于防止同一张小票分多次支付,以享受多次优惠的情况,正常支付订单不必上传此参数。
示例值:608800
商品小票ID receipt_id string(32) 商家小票ID
示例值:wx123
+ 单品列表 goods_detail Array 单品信息,使用Json格式
参数名 变量 类型 必填 描述
商品编码 goods_id string(32) 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成
示例值:12345
微信支付商品编码 wxpay_goods_id string(32) 微信支付定义的统一商品编号(没有可不传)
示例值:1001
商品名称 goods_name string(256) 商品的实际名称
示例值:iPhone6s 16G
商品数量 quantity int 用户购买的数量
示例值:1
商品单价 price int 如果商户有优惠,需传输商户优惠后的单价(例如:用户对一笔100元的订单使用了商场发的优惠券100-50,则活动商品的单价应为原单价-50)
示例值:528800

请求示例:



{
	"sp_appid": "wx2421b1c4370ec43b",
	"sp_mchid": "10000100",
	"sub_mchid": "20000100",
	"sub_appid": "wx352671b037b437ec",
	"out_trade_no": "20171014125314",
	"merchant_category_code": "1011",
	"payer": {
		"sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
	},
	"notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
	"trade_type": "APP",
	"amount": {
		"total": 10000,
		"currency": "HKD"
	},
	"attach": "Payment test",
	"description": "In-APP Pay test",
	"goods_tag": "",
	"detail": {
		"cost_price": 10000,
		"receipt_id": "1234",
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"wxpay_goods_id": "1001",
			"goods_name": "iPhone6s 16G",
			"quantity": 1,
			"price": 528800
		}]
	},
	"scene_info": {
		"payer_client_ip": "14.23.150.211",
		"device_ip": "59.37.125.32",
		"device_id": "013467007045764",
		"operator_id": "P001",
		"store_info": {
			"id": "SZTX001"
		}
	}
}
    
{
	"appid": "wx2421b1c4370ec43b",
	"mchid": "10000100",
	"out_trade_no": "20171014125314",
	"merchant_category_code": "1011",
	"payer": {
		"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
	},
	"notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
	"trade_type": "APP",
	"amount": {
		"total": 10000,
		"currency": "HKD"
	},
	"attach": "Payment test",
	"description": "In-APP Pay test",
	"goods_tag": "",
	"detail": {
		"cost_price": 10000,
		"receipt_id": "1234",
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"wxpay_goods_id": "1001",
			"goods_name": "iPhone6s 16G",
			"quantity": 1,
			"price": 528800
		}]
	},
	"scene_info": {
		"payer_client_ip": "14.23.150.211",
		"device_ip": "59.37.125.32",
		"device_id": "013467007045764",
		"operator_id": "P001",
		"store_info": {
			"id": "SZTX001"
		}
	}
}
    

返回参数

正常返回

参数名 变量 类型 必填 描述
预支付交易会话标识 prepay_id string(64) 微信生成的预支付会话标识,用于后续接口调用中使用,该值有效期为2小时
示例值:wx201410272009395522657a690389285100

异常返回

参数名 变量 类型 必填 描述
返回状态码 code string(32) 错误码,枚举值见错误码列表
示例值:INVALID_REQUEST
返回信息 message string(256) 返回信息,如非空,为错误原因
示例值:参数格式校验错误
+ 详细的错误描述 detail object 当code为PARAM_ERROR时返回,详细说明见下
参数名 变量 类型 必填 描述
指示错误参数的位置 field string(256) 当错误参数位于请求body的JSON时,填写指向参数的JSON Pointer;
当错误参数位于请求的url或者querystring时,填写参数的变量名
示例值:#/properties/payer
错误参数的值 value string(256) 错误参数的值
示例值:1346177081915535577
具体错误原因 issue string(256) 具体错误原因
示例值:与ALLOF schema不符
错误参数的位置 location string(256) body:错误参数位于请求body的JSON中
url:错误参数位于请求url中
query:错误参数位于请求的querystring中
示例值:body

返回示例:

{
    "prepay_id": "wx201411101639507cbf6ffd8b0779950874"
}

{
"code":"INVALID_REQUEST",
"message":"参数格式校验错误",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"与ALLOF schema不符",
    "location":"body"
   }
}

错误码

错误码 描述 解决方案
NOAUTH 商户无此接口权限 请商户前往申请此接口权限
NOTENOUGH 余额不足 用户账号余额不足,请用户充值或更换支付卡后再支付
ORDERPAID 商户订单已支付 商户订单已支付,无需更多操作
ORDERCLOSED 订单已关闭 当前订单已关闭,请重新下单
SYSTEMERROR 系统错误 系统异常,请用相同参数重新调用
APPID_NOT_EXIST APPID不存在 请检查APPID是否正确
MchID_NOT_EXIST MchID不存在 请检查MchID是否正确
APPID_MchID_NOT_MATch appid和mchid不匹配 请确认appid和mchid是否匹配
LACK_PARAMS 缺少参数 请检查参数是否齐全
OUT_TRADE_NO_USED 商户订单号重复 请核实商户订单号是否重复提交
SIGNERROR 签名错误 请检查签名参数和方法是否都符合签名算法要求
REQUIRE_POST_METHOD 请使用post方法 请检查请求参数是否通过post方法提交
POST_DATA_EMPTY post数据为空 请检查post数据是否为空
NOT_UTF8 编码格式错误 请使用UTF-8编码格式


版本说明

关闭
V1.1
2022年3月10日
1. 请求参数promotion_detail调整为detail
V1.0
2020年1月08日
1. 下单接口上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global