提交付款码支付

更新时间:2025.03.21

通过本接口提交微信支付付款码支付订单。


1. 接口说明

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

请求URL: https://apihk.mch.weixin.qq.com/v3/global/micropay/transactions/pay

请求方式: POST

频率限制:150qps

 

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

商户号

mchid

string[1, 32]

Body 微信支付分配的商户号
注意:仅适用于直连模式
示例值:1900000109

APPID

appid

string[1, 32]

Body 商户在微信公众平台申请服务号对应的APPID
注意:仅适用于直连模式
示例值:wx8888888888888888

子商户号

sub_mchid

string[1, 32]

Body 微信支付分配的子商户号
注意:仅适用于机构模式
示例值:1900000109

机构商户号

sp_mchid

string[1, 32]

Body 微信支付分配的机构商户号
注意:仅适用于机构模式
示例值:1900000100

机构APPID

sp_appid

string[1, 32]

Body 机构在微信公众平台申请服务号对应的APPID
注意:仅适用于机构模式
示例值:wx8888888888888888

子商户APPID

sub_appid

string[1, 32]

Body 子商户在微信开放平台申请移动应用对应的APPID
注意:仅适用于机构模式
示例值:wx8888888888888888

商品描述

description

string[1, 127]

Body 商品或支付单简要描述,格式要求:门店品牌名-城市分店名-实际商品名称
示例值:image形象店-深圳腾大- QQ公仔

商户数据

attach

string[1, 127]

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

商户订单号

out_trade_no

string[1, 32]

Body 商户系统内部的订单号,32个字符内、可包含字母;重新下单时请更换单号,其他说明见商户订单号
示例值:1217752501201407033233368018

商品标记

goods_tag

string[1, 32]

Body 商品标记
示例值:WXG

交易类型

trade_type

string[1, 16]

Body MICROPAY:刷卡支付
示例值:MICROPAY

指定支付方式

limit_pay

string[1, 32]

Body no_credit:指定不能使用信用卡支付
示例值:no_credit

MCC码

merchant_category_code

string[1, 16]

Body 商户行业编码,值列表详见商户行业编码
示例值:4111

支付者

payer

object

Body 支付者信息,详细说明见下文

支付者

订单金额

amount

object

Body 订单金额信息,详细说明见下文

订单金额

场景信息

scene_info

object

Body 场景信息对象,详细说明见下文

场景信息

优惠功能

detail

array

Body 优惠功能信息,详细说明见下文

优惠功能

 

请求示例

机构模式

1{
2	"sp_appid": "wxdace645e0bc2c424",
3	"sp_mchid": "10000100",
4	"sub_mchid": "20000100",
5	"out_trade_no": "20150806125346",
6	"merchant_category_code": "4111",
7	"payer": {
8		"auth_code": "134650720866361395"
9	},
10	"trade_type": "MICROPAY",
11	"amount": {
12		"total": 1,
13		"currency": "HKD"
14	},
15	"attach": "Payment Test",
16	"description": "Image Store - Tencent Building in Shenzhen - QQ Doll",
17	"goods_tag": "1234",
18	"limit_pay": "no_credit",
19	"detail": [{
20		"cost_price": 1,
21		"receipt_id": "1234",
22		"goods_detail": [{
23			"goods_id": "iphone6s_16G",
24			"wxpay_goods_id": "3405",
25			"goods_name": "iPhone6s 16G",
26			"quantity": 1,
27			"price": 1
28		}]
29	}],
30	"scene_info": {
31		"payer_client_ip": "14.23.150.211",
32		"device_ip": "59.37.125.32",
33		"device_id": "013467007045764",
34		"operator_id": "P001",
35		"store_info": {
36			"id": "SZTX001",
37			"name": "Tencent Building Branch",
38			"address": "Nanshan District, Shenzhen, Guangdong"
39		}
40	}
41}  

直连模式

1{
2	"appid": "wxdace645e0bc2c424",
3	"mchid": "10000100",
4	"out_trade_no": "20150806125346",
5	"merchant_category_code": "4111",
6	"payer": {
7		"auth_code": "134650720866361395"
8	},
9	"trade_type": "MICROPAY",
10	"amount": {
11		"total": 1,
12		"currency": "HKD"
13	},
14	"attach": "Payment Test",
15	"description": "Image Store - Tencent Building in Shenzhen - QQ Doll",
16	"goods_tag": "1234",
17	"limit_pay": "no_credit",
18	"detail": [{
19		"cost_price": 1,
20		"receipt_id": "1234",
21		"goods_detail": [{
22			"goods_id": "iphone6s_16G",
23			"wxpay_goods_id": "3405",
24			"goods_name": "iPhone6s 16G",
25			"quantity": 1,
26			"price": 1
27		}]
28	}],
29	"scene_info": {
30		"payer_client_ip": "14.23.150.211",
31		"device_ip": "59.37.125.32",
32		"device_id": "013467007045764",
33		"operator_id": "P001",
34		"store_info": {
35			"id": "SZTX001",
36			"name": "Tencent Building Branch",
37			"address": "Nanshan District, Shenzhen, Guangdong"
38		}
39	}
40}

 

3. 返回参数

正常返回

参数名

变量

类型[长度限制]

必填

描述

微信支付订单号

id

string[1, 32]

微信支付订单号
示例值:1217752501201407033233368018

商户号

mchid

string[1, 32]

微信支付分配的商户号
注意:仅适用于直连模式
示例值:1900000109

APPID

appid

string[1, 32]

商户在微信公众平台申请服务号对应的APPID
注意:仅适用于直连模式
示例值:wx8888888888888888

子商户号

sub_mchid

string[1, 32]

微信支付分配的子商户号
注意:仅适用于机构模式
示例值:1900000109

机构商户号

sp_mchid

string[1, 32]

微信支付分配的机构商户号
注意:仅适用于机构模式
示例值:1900000100

机构APPID

sp_appid

string[1, 32]

机构在微信公众平台申请服务号对应的APPID
示例值:wx8888888888888888

子商户APPID

sub_appid

string[1, 32]

子商户在微信开放平台申请移动应用对应的APPID
示例值:wx8888888888888888

商户订单号

out_trade_no

string[1, 32]

返回的商户订单号
示例值:1217752501201407033233368018

交易类型

trade_type

string[1, 16]

刷卡支付
示例值:MICROPAY

交易状态

trade_state

string[1, 32]

SUCCESS—支付成功
REFUND—转入退款
NOTPAY—未支付
CLOSED—已关闭
REVOKED—已撤销(刷卡支付)
USERPAYING--用户支付中
PAYERROR--支付失败(其他原因,如银行返回失败)
示例值:SUCCESS

交易状态描述

trade_state_desc

string[1, 256]

对当前订单状态的描述和下一步操作的指引
示例值:支付失败,请重新下单支付

付款银行

bank_type

string[1, 32]

银行类型,采用字符串类型的银行标识,值列表详见银行类型
示例值:CMC

商户数据

attach

string(1, 127)

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

支付完成时间

success_time

string[1, 64]

订单支付成功时间,格式为rfc3339格式,如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒
示例值:2018-06-08T10:34:56+08:00

支付者

payer

object

支付者信息,详细说明见下文

支付者

订单金额

amount

object

订单金额信息,详细说明见下文

订单金额

优惠功能

promotion_detail

Object

优惠功能信息,详细说明见下文

优惠功能

注意

goods_remark为备注字段,按照配置原样返回,goods_tag是订单优惠标记,用于区分订单是否可以享受优惠,两个字段内容都在微信后台配置券时进行设置。

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

错误码,枚举值见错误码列表
示例值:INVALID_REQUEST

返回信息

message

string[1, 256]

返回信息,如非空,为错误原因
示例值:参数格式校验错误

详细的错误描述

detail

Object

当code为PARAM_ERROR时返回,详细说明见下

详细的错误描述

返回示例

正常示例

1{
2	"sp_appid": "wxdace645e0bc2c424",
3	"sp_mchid": "10000100",
4	"sub_mchid": "20000100",
5	"out_trade_no": "20150806125346",
6	"merchant_category_code": "4111",
7	"payer": {
8		"auth_code": "134650720866361395"
9	},
10	"trade_type": "MICROPAY",
11	"amount": {
12		"total": 1,
13		"currency": "HKD"
14	},
15	"attach": "Payment Test",
16	"description": "Image Store - Tencent Building in Shenzhen - QQ Doll",
17	"goods_tag": "1234",
18	"limit_pay": "no_credit",
19	"promotion_detail": [{
20		"cost_price": 1,
21		"receipt_id": "1234",
22		"goods_detail": [{
23			"goods_id": "iphone6s_16G",
24			"wxpay_goods_id": "3405",
25			"goods_name": "iPhone6s 16G",
26			"quantity": 1,
27			"price": 1
28		}]
29	}],
30	"scene_info": {
31		"payer_client_ip": "14.23.150.211",
32		"device_ip": "59.37.125.32",
33		"device_id": "013467007045764",
34		"operator_id": "P001",
35		"store_info": {
36			"id": "SZTX001",
37			"name": "Tencent Building Branch",
38			"address": "Nanshan District, Shenzhen, Guangdong"
39		}
40	}
41}

异常示例

1{
2	"code": "INVALID_REQUEST",
3	"message": "Parameter format verification error",
4	"detail": {
5		"field": "#/properties/payer",
6		"value": "1346177081915535577",
7		"issue": "与ALLOF schema不符",
8		"location": "body"
9	}
10}

4. 错误码

错误码

描述

解决方案

INVALID_REQUEST

无效请求

请根据接口返回的详细错误描述信息检查您的程序

TRADE_ERROR

交易失败

提示用户更换支付方式

SYSTEM_ERROR

系统错误

请用原请求参数再次调用支付接口以确认结果。如果持续返回SYSTEMERROR,请调用撤销接口,并告知用户更换支付方式。

PARAM_ERROR

请求参数错误

请根据接口返回的详细错误描述信息检查您的程序

NOT_ENOUGH

余额不足

提示用户余额不足或更换支付方式

AUTH_CODE_INVALID

付款码无效

请检查是否是微信的付款码。然后更换out_trade_no和付款码后再次发起支付。

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.