支付结果通知api

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断

返回信息

return_msg

否

String(128)

签名失败

返回信息，如非空，为错误原因

签名失败

参数格式校验错误

请求appid

appid

是

String(32)

wxcbda96de0b165486

appid是商户在微信申请公众号或移动应用成功后分配的账号ID，登录平台为mp.weixin.qq.com或open.weixin.qq.com

子商户公众账号id

sub_appid

否

String(32)

wxcbda96de0b165489

微信分配的子商户公众账号ID

商户号

mch_id

是

String(32)

10000098

商户号是商户在微信申请微信支付成功后分配的账号ID，登录平台为pay.weixin.qq.com

子商户号

sub_mch_id

是

String(32)

1900000109

微信支付分配的子商户号

设备号

device_info

否

String(32)

013467007045764

微信支付分配的终端设备号，

随机字符串

nonce_str

是

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

随机字符串，不长于32位

签名类型

sign_type

是

String(32)

HMAC-SHA256

签名类型，默认为HMAC-SHA256

签名

sign

是

String(64)

EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5

签名，详见签名生成算法

业务结果

result_code

是

String(16)

SUCCESS

SUCCESS/FAIL

错误代码

err_code

否

String(32)

SYSTEMERROR

错误返回的信息描述

错误代码描述

err_code_des

否

String(128)

系统错误

错误返回的信息描述

用户标识

openid

是

String(128)

wxd930ea5d5a258f4f

用户在商户appid下的唯一标识

用户子标识

sub_openid

否

String(32)

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

sub_appid下，用户的唯一标识

是否关注公众账号

is_subscribe

否

String(1)

Y

用户是否关注公众账号，Y-关注，N-未关注，仅在公众账号类型支付有效

是否关注子公众账号

sub_is_subscribe

否

String(1)

Y

用户是否关注子公众账号，Y-关注，N-未关注，仅在公众账号类型支付有效

付款银行

bank_type

是

String(32)

CMC

银行类型，采用字符串类型的银行标识，银行类型见银行列表。如果订单发⽣垫资且申请扣费api请求参数中的version值为2.0，则固定返回值：BPA。

总金额

total_fee

是

int

100

订单总金额，单位为分(trade_state为SUCCESS和REFUND时才有返回)

货币种类

fee_type

否

String(8)

CNY

货币类型，符合ISO4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型

现金支付金额

cash_fee

是

int

100

现金支付金额订单现金支付金额，详见支付金额

现金支付货币类型

cash_fee_type

否

String(16)

CNY

货币类型，符合ISO4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型

交易状态

trade_state

是

String(32)

SUCCESS

SUCCESS--支付成功
PAY_FAIL--支付失败(其他原因，如银行返回失败)

代金券或立减优惠金额

coupon_fee

否

int

10

代金券或立减优惠金额<=订单总金额，订单总金额-代金券或立减优惠金额=现金支付金额，详见支付金额

代金券或立减优惠使用数量

coupon_count

否

int

1

代金券或立减优惠使用数量

代金券或立减优惠ID

coupon_id_$n

否

String(20)

10000

代金券或立减优惠ID,$n为下标，从0开始编号

单个代金券或立减优惠支付金额

coupon_fee_$n

否

int

100

单个代金券或立减优惠支付金额,$n为下标，从0开始编号

微信支付订单号

transaction_id

是

String(32)

1217752501201407033233368018

微信支付订单号

商户订单号

out_trade_no

是

String(32)

1212321211201407033568112322

商户系统的订单号，与请求一致。

商家数据包

attach

否

String(128)

123456

商家数据包，原样返回

支付完成时间

time_end

是

String(14)

20141030133525

支付完成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则

交易类型

trade_type

是

String(16)

PAP

交易类型

委托代扣协议id

contract_id

是

String(32)

Wx15463511252015071056489715

签约成功后，微信返回的委托代扣协议id

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

SUCCESS表示商户接收通知成功并校验成功

返回信息

return_msg

否

String(128)

OK

返回信息，如非空，为错误原因：

签名失败

参数格式校验错误

ACCOUNT_ERROR

用户账户异常

用户账号注销、银行卡异常或注销

建议更换银行卡支付

CONTRACT_NOT_EXIST

用户签约已过期或者取消

用户签约协议已过期或已解约

建议重新签约

RULE_LIMIT

用户账户支付已达上限

用户支付银行卡限额不足

建议更换银行卡支付

BANK_ERROR

支付银行卡所在行渠道维护中

用户支付银行暂时无法提供服务

建议更换银行卡支付

NOTENOUGH

余额不足

用户余额不足

建议更换银行卡支付

SYSTEMERROR

系统错误

未知原因导致的错误

请重新发起扣款

TRADE_ERROR

支付确认失败

用户的微信号被风控拦截或者用户的微信号被紧急冻结

提示用户可咨询微信客服了解具体原因