微信支付开发刷卡支付

Posted 2022-11-30 方倍工作室

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了微信支付开发刷卡支付相关的知识，希望对你有一定的参考价值。

关键字：微信支付微信支付v3 刷卡支付统一支付 prepay_id
作者：方倍工作室

本文介绍微信支付下的刷卡支付的开发过程。微信刷卡支付是指用户打开微信钱包的刷卡的界面，商户扫码后提交完成支付的支付过程。

一、刷卡支付API

接口地址

https://api.mch.weixin.qq.com/pay/micropay

是否需要证书

不需要。

输入参数

名称	变量名	必填	类型	示例值	描述
公众账号ID	appid	是	String(32)	wx8888888888888888	微信分配的公众账号ID（企业号corpid即为此appId）
商户号	mch_id	是	String(32)	1900000109	微信支付分配的商户号
设备号	device_info	否	String(32)	013467007045764	终端设备号(商户自定义，如门店编号)
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位。推荐随机数生成算法
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名，详见签名生成算法
商品描述	body	是	String(128)	image形象店-深圳腾大- QQ公仔	商品简单描述，该字段须严格按照规范传递，具体请见参数规定
商品详情	detail	否	String(6000)	"goods_detail":[ "goods_id":"iphone6s_16G", "wxpay_goods_id":"1001", "goods_name":"iPhone6s 16G", "goods_num":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 商品名称 └ goods_num Int 必填商品数量 └ price Int 必填商品单价，单位为分 └ goods_category String 可选 32 商品类目ID └ body String 可选 1000 商品描述信息
附加数据	attach	否	String(127)	说明	附加数据，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据
商户订单号	out_trade_no	是	String(32)	1217752501201407033233368018	商户系统内部的订单号,32个字符内、可包含字母,其他说明见商户订单号
商品详情	detail	否	String(8192)	与提交数据一致	实际提交的返回
订单金额	total_fee	是	Int	888	订单总金额，单位为分，只能为整数，详见支付金额
货币类型	fee_type	否	String(16)	CNY	符合ISO4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
终端IP	spbill_create_ip	是	String(16)	8.8.8.8	调用微信支付API的机器IP
商品标记	goods_tag	否	String(32)		商品标记，代金券或立减优惠功能的参数，说明详见代金券或立减优惠
指定支付方式	limit_pay	否	String(32)	no_credit	no_credit--指定不能使用信用卡支付
授权码	auth_code	是	String(128)	120061098828009406	扫码支付授权码，设备读取用户微信中的条码或者二维码信息

举例如下：

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <attach>订单额外描述</attach>
   <auth_code>120269300684844649</auth_code>
   <body>刷卡支付测试</body>
   <device_info>1000</device_info>
   <goods_tag></goods_tag>
   <mch_id>10000100</mch_id>
   <nonce_str>8aaee146b1dee7cec9100add9b96cbe2</nonce_str>
   <out_trade_no>1415757673</out_trade_no>
   <spbill_create_ip>14.17.22.52</spbill_create_ip>
   <time_expire></time_expire>
   <total_fee>1</total_fee>
   <sign>C29DB7DB1FD4136B84AE35604756362C</sign>
</xml>

注：参数值用XML转义即可，CDATA标签用于说明数据不被XML解析器解析。

返回结果

名称	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
返回信息	return_msg	否	String(128)	签名失败	返回信息，如非空，为错误原因签名失败参数格式校验错误

当return_code为SUCCESS的时候，还会包括以下字段：

名称	变量名	必填	类型	示例值	描述
公众账号ID	appid	是	String(32)	wx8888888888888888	调用接口提交的公众账号ID
商户号	mch_id	是	String(32)	1900000109	调用接口提交的商户号
设备号	device_info	否	String(32)	013467007045764	调用接口提交的终端设备号，
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	微信返回的随机字符串
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	微信返回的签名，详见签名生成算法
业务结果	result_code	是	String(16)	SUCCESS	SUCCESS/FAIL
错误代码	err_code	否	String(32)	SYSTEMERROR	详细参见错误列表
错误代码描述	err_code_des	否	String(128)	系统错误	错误返回的信息描述

当return_code 和result_code都为SUCCESS的时，还会包括以下字段：

名称	变量名	必填	类型	示例值	描述
用户标识	openid	是	String(128)	Y	用户在商户appid 下的唯一标识
是否关注公众账号	is_subscribe	是	String(1)	Y	用户是否关注公众账号，仅在公众账号类型支付有效，取值范围：Y或N;Y-关注;N-未关注
交易类型	trade_type	是	String(16)	MICROPAY	支付类型为MICROPAY(即扫码支付)
付款银行	bank_type	是	String(16)	CMC	银行类型，采用字符串类型的银行标识，值列表详见银行类型
货币类型	fee_type	否	String(16)	CNY	符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
订单金额	total_fee	是	Int	888	订单总金额，单位为分，只能为整数，详见支付金额
现金支付货币类型	cash_fee_type	否	String(16)	CNY	符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
现金支付金额	cash_fee	是	Int	100	订单现金支付金额，详见支付金额
微信支付订单号	transaction_id	是	String(32)	1217752501201407033233368018	微信支付订单号
商户订单号	out_trade_no	是	String(32)	1217752501201407033233368018	商户系统的订单号，与请求一致。
商家数据包	attach	否	String(128)	123456	商家数据包，原样返回
支付完成时间	time_end	是	String(14)	20141030133525	订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。详见时间规则