华寸科技

南安微信小程序支付（微信支付）文档API列表：申请退款，查询退款，下载对账单

发表时间：2021-12-20 22:05

申请退款

应用场景

当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。

注意：

1、交易时间超过一年的订单无法提交退款；

2、微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交，要采用原来的退款单号。总退款金额不能超过用户实际支付金额。

接口地址

是否需要证书

请求需要双向证书。详见证书使用

请求参数

字段名	变量名	必填	类型	示例值	描述
小程序ID	appid	是	String(32)	wx8888888888888888	微信分配的小程序ID
商户号	mch_id	是	String(32)	1900000109	微信支付分配的商户号
设备号	device_info	否	String(32)	013467007045764	终端设备号
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位。推荐随机数生成算法
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名，详见签名生成算法
签名类型	sign_type	否	String(32)	HMAC-SHA256	签名类型，目前支持HMAC-SHA256和MD5，默认为MD5
微信订单号	transaction_id	二选一	String(28)	1217752501201407033233368018	微信生成的订单号，在支付通知中有返回
商户订单号	out_trade_no	二选一	String(32)	1217752501201407033233368018	商户侧传给微信的订单号
商户退款单号	out_refund_no	是	String(32)	1217752501201407033233368018	商户系统内部的退款单号，商户系统内部**，同一退款单号多次请求只退一笔
订单金额	total_fee	是	Int	100	订单总金额，单位为分，只能为整数，详见支付金额
退款金额	refund_fee	是	Int	100	退款总金额，订单总金额，单位为分，只能为整数，详见支付金额
货币种类	refund_fee_type	否	String(8)	CNY	货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
操作员	op_user_id	是	String(32)	1900000109	操作员帐号, 默认为商户号
退款资金来源	refund_account	否	String(30)	REFUND_SOURCE_RECHARGE_FUNDS	仅针对老资金流商户使用 REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款（默认使用未结算资金退款） REFUND_SOURCE_RECHARGE_FUNDS---可用余额退款

举例如下：

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <mch_id>10000100</mch_id>
   <nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
   <op_user_id>10000100</op_user_id>
   <out_refund_no>1415701182</out_refund_no>
   <out_trade_no>1415757673</out_trade_no>
   <refund_fee>1</refund_fee>
   <total_fee>1</total_fee>
   <transaction_id></transaction_id>
   <sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
</xml>

返回结果

字段名

变量名

必填

类型

示例值

描述

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

返回信息

return_msg

否

String(128)

签名失败

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

签名失败

参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

字段名	变量名	必填	类型	示例值	描述
业务结果	result_code	是	String(16)	SUCCESS	SUCCESS/FAIL SUCCESS退款申请接收成功，结果通过退款查询接口查询 FAIL 提交业务失败
错误代码	err_code	否	String(32)	SYSTEMERROR	列表详见错误码列表
错误代码描述	err_code_des	否	String(128)	系统超时	结果信息描述
小程序ID	appid	是	String(32)	wx8888888888888888	微信分配的小程序ID
商户号	mch_id	是	String(32)	1900000109	微信支付分配的商户号
设备号	device_info	否	String(32)	013467007045764	微信支付分配的终端设备号，与下单一致
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位
签名	sign	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	签名，详见签名算法

文章分类：优化知识

分享到：

HC TECHNOLOGY

联系

地址：泉州丰泽区云鹿路兴祥大厦2楼

电话： 13067030702

邮箱：lai@qzhckj.cn