一起源码网

  • www.171739.xyz
  • 全球最大的互联网技术和资源下载平台
搜索
一起源码网 门户 高级进阶 查看主题

微信小程序支付(微信支付)文档API列表:申请退款,查询退款,下载对账单 ... ...

发布者: cscwsn | 发布时间: 2017-12-19 03:35| 查看数: 3605| 评论数: 1|帖子模式

申请退款

应用场景

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

注意:

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

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

接口地址

接口链接:https://api.mch.weixin.qq.com/secapi/pay/refund

是否需要证书

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

请求参数

字段名变量名必填类型示例值描述
小程序IDappidString(32)wx8888888888888888微信分配的小程序ID
商户号mch_idString(32)1900000109微信支付分配的商户号
设备号device_infoString(32)013467007045764终端设备号
随机字符串nonce_strString(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串,不长于32位。推荐随机数生成算法
签名signString(32)C380BEC2BFD727A4B6845133519F3AD6签名,详见签名生成算法
签名类型sign_typeString(32)HMAC-SHA256签名类型,目前支持HMAC-SHA256和MD5,默认为MD5
微信订单号transaction_id二选一String(28)1217752501201407033233368018微信生成的订单号,在支付通知中有返回
商户订单号out_trade_noString(32)1217752501201407033233368018商户侧传给微信的订单号
商户退款单号out_refund_noString(32)1217752501201407033233368018商户系统内部的退款单号,商户系统内部唯一,同一退款单号多次请求只退一笔
订单金额total_feeInt100订单总金额,单位为分,只能为整数,详见支付金额
退款金额refund_feeInt100退款总金额,订单总金额,单位为分,只能为整数,详见支付金额
货币种类refund_fee_typeString(8)CNY货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型
操作员op_user_idString(32)1900000109操作员帐号, 默认为商户号
退款资金来源refund_accountString(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_codeString(16)SUCCESSSUCCESS/FAIL
返回信息return_msgString(128)签名失败

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

签名失败

参数格式校验错误

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

字段名变量名必填类型示例值描述
业务结果result_codeString(16)SUCCESS

SUCCESS/FAIL

SUCCESS退款申请接收成功,结果通过退款查询接口查询

FAIL 提交业务失败

错误代码err_codeString(32)SYSTEMERROR列表详见错误码列表
错误代码描述err_code_desString(128)系统超时结果信息描述
小程序IDappidString(32)wx8888888888888888微信分配的小程序ID
商户号mch_idString(32)1900000109微信支付分配的商户号
设备号device_infoString(32)013467007045764微信支付分配的终端设备号,与下单一致
随机字符串nonce_strString(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串,不长于32位
签名signString(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS签名,详见签名算法
微信订单号transaction_idString(28)4007752501201407033233368018微信订单号
商户订单号out_trade_noString(32)33368018商户系统内部的订单号
商户退款单号out_refund_noString(32)121775250商户退款单号
微信退款单号refund_idString(28)2007752501201407033233368018微信退款单号
退款渠道refund_channelString(16)ORIGINAL

ORIGINAL—原路退款

BALANCE—退回到余额

申请退款金额refund_feeInt100退款总金额,单位为分,可以做部分退款
退款金额settlement_refund_feeInt100去掉非充值代金券退款金额后的退款金额,退款金额=申请退款金额-非充值代金券退款金额,退款金额<=申请退款金额
订单金额total_feeInt100订单总金额,单位为分,只能为整数,详见支付金额
应结订单金额settlement_total_feeInt100去掉非充值代金券金额后的订单总金额,应结订单金额=订单金额-非充值代金券金额,应结订单金额<=订单金额。
订单金额货币种类fee_typeString(8)CNY订单金额货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型
现金支付金额cash_feeInt100现金支付金额,单位为分,只能为整数,详见支付金额
现金退款金额cash_refund_feeInt100现金退款金额,单位为分,只能为整数,详见支付金额
代金券类型coupon_type_$nString(8)CASH

CASH--充值代金券 

NO_CASH---非充值代金券

订单使用代金券时有返回(取值:CASH、NO_CASH)。$n为下标,从0开始编号,举例:coupon_type_0

代金券退款金额coupon_refund_fee_$nInt100代金券退款金额<=退款金额,退款金额-代金券或立减优惠退款金额为现金,说明详见代金券或立减优惠
退款代金券使用数量coupon_refund_count_$nInt1退款代金券使用数量 ,$n为下标,从0开始编号
退款代金券批次IDcoupon_refund_batch_id_$n_$mString(20)100退款代金券批次ID ,$n为下标,$m为下标,从0开始编号
退款代金券IDcoupon_refund_id_$n_$mString(20)10000 退款代金券ID, $n为下标,$m为下标,从0开始编号
单个退款代金券支付金额coupon_refund_fee_$n_$mInt100单个退款代金券支付金额, $n为下标,$m为下标,从0开始编号

举例如下:

<xml>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></mch_id>
   <nonce_str><![CDATA[NfsMFbUFpdbEhPXP]]></nonce_str>
   <sign><![CDATA[B7274EB9F8925EB93100DD2085FA56C0]]></sign>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
   <out_trade_no><![CDATA[1415757673]]></out_trade_no>
   <out_refund_no><![CDATA[1415701182]]></out_refund_no>
   <refund_id><![CDATA[2008450740201411110000174436]]></refund_id>
   <refund_channel><![CDATA[]]></refund_channel>
   <refund_fee>1</refund_fee> 
</xml>

错误码

名称描述原因解决方案
SYSTEMERROR接口返回错误系统超时请用相同参数再次调用API
USER_ACCOUNT_ABNORMAL退款请求失败用户帐号注销此状态代表退款申请失败,商户可自行处理退款。
NOTENOUGH余额不足商户可用退款余额不足此状态代表退款申请失败,商户可根据具体的错误提示做相应的处理。
INVALID_TRANSACTIONID无效transaction_id请求参数未按指引进行填写请求参数错误,检查原交易号是否存在或发起支付交易接口返回失败
PARAM_ERROR参数错误请求参数未按指引进行填写请求参数错误,请重新检查再调用退款申请
APPID_NOT_EXISTAPPID不存在参数中缺少APPID请检查APPID是否正确
MCHID_NOT_EXISTMCHID不存在参数中缺少MCHID请检查MCHID是否正确
APPID_MCHID_NOT_MATCHappid和mch_id不匹配appid和mch_id不匹配请确认appid和mch_id是否匹配
REQUIRE_POST_METHOD请使用post方法未使用post传递参数 请检查请求参数是否通过post方法提交
SIGNERROR签名错误参数签名结果不正确请检查签名参数和方法是否都符合签名算法要求
XML_FORMAT_ERRORXML格式错误XML格式错误请检查XML参数格式是否正确

查询退款

应用场景

提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,用零钱支付的退款20分钟内到账,银行卡支付的退款3个工作日后重新查询退款状态。

接口地址

接口链接:https://api.mch.weixin.qq.com/pay/refundquery

是否需要证书

不需要。

请求参数

字段名变量名必填类型示例值描述
小程序IDappidString(32)wx8888888888888888微信分配的小程序ID
商户号mch_idString(32)1900000109微信支付分配的商户号
设备号device_infoString(32)013467007045764商户自定义的终端设备号,如门店编号、设备的ID等
随机字符串nonce_strString(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串,不长于32位。推荐随机数生成算法
签名signString(32)C380BEC2BFD727A4B6845133519F3AD6签名,详见签名生成算法
签名类型sign_typeString(32)HMAC-SHA256签名类型,目前支持HMAC-SHA256和MD5,默认为MD5
微信订单号transaction_id四选一String(32)1217752501201407033233368018微信订单号
商户订单号out_trade_noString(32)1217752501201407033233368018商户系统内部的订单号
商户退款单号out_refund_noString(32)1217752501201407033233368018商户侧传给微信的退款单号
微信退款单号refund_idString(28)1217752501201407033233368018

微信生成的退款单号,在申请退款接口有返回

举例如下:

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <mch_id>10000100</mch_id>
   <nonce_str>0b9f35f484df17a732e537c37708d1d0</nonce_str>
   <out_refund_no></out_refund_no>
   <out_trade_no>1415757673</out_trade_no>
   <refund_id></refund_id>
   <transaction_id></transaction_id>
   <sign>66FFB727015F450D167EF38CCC549521</sign>
</xml>

返回数据

字段名变量名必填类型示例值描述
返回状态码return_codeString(16)SUCCESSSUCCESS/FAIL
返回信息return_msgString(128)签名失败

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

签名失败

参数格式校验错误

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

字段名变量名必填类型示例值描述
业务结果result_codeString(16)SUCCESS

SUCCESS/FAIL

SUCCESS退款申请接收成功,结果通过退款查询接口查询

FAIL

错误码err_codeString(32)SYSTEMERROR错误码详见第6节
错误描述err_code_desString(32)系统错误结果信息描述
小程序IDappidString(32)wx8888888888888888微信分配的小程序ID
商户号mch_idString(32)1900000109微信支付分配的商户号
设备号device_infoString(32)013467007045764终端设备号
随机字符串nonce_strString(28)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串,不长于32位
签名signString(32)C380BEC2BFD727A4B6845133519F3AD6签名,详见签名算法
微信订单号transaction_idString(32)1217752501201407033233368018微信订单号
商户订单号out_trade_noString(32)1217752501201407033233368018商户系统内部的订单号
订单金额total_feeInt100订单总金额,单位为分,只能为整数,详见支付金额
应结订单金额settlement_total_feeInt100应结订单金额=订单金额-非充值代金券金额,应结订单金额<=订单金额。
货币种类fee_typeString(8)CNY订单金额货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型
现金支付金额cash_feeInt100现金支付金额,单位为分,只能为整数,详见支付金额
退款笔数refund_countInt1退款记录数
商户退款单号out_refund_no_$nString(32)1217752501201407033233368018商户退款单号
微信退款单号refund_id_$nString(28)1217752501201407033233368018微信退款单号
退款渠道refund_channel_$nString(16)ORIGINAL

ORIGINAL—原路退款

BALANCE—退回到余额

申请退款金额refund_fee_$nInt100退款总金额,单位为分,可以做部分退款
退款金额settlement_refund_fee_$nInt100退款金额=申请退款金额-非充值代金券退款金额,退款金额<=申请退款金额
退款资金来源refund_accountString(30)REFUND_SOURCE_RECHARGE_FUNDS

REFUND_SOURCE_RECHARGE_FUNDS---可用余额退款/基本账户

REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款

代金券类型coupon_type_$nIntCASH

CASH--充值代金券 

NO_CASH---非充值代金券

订单使用代金券时有返回(取值:CASH、NO_CASH)。$n为下标,从0开始编号,举例:coupon_type_$0

代金券退款金额coupon_refund_fee_$nInt100代金券退款金额<=退款金额,退款金额-代金券或立减优惠退款金额为现金,说明详见代金券或立减优惠
退款代金券使用数量coupon_refund_count_$nInt1退款代金券使用数量 ,$n为下标,从0开始编号
退款代金券批次IDcoupon_refund_batch_id_$n_$mString(20)100退款代金券批次ID ,$n为下标,$m为下标,从0开始编号
退款代金券IDcoupon_refund_id_$n_$mString(20)10000 退款代金券ID, $n为下标,$m为下标,从0开始编号
单个退款代金券支付金额coupon_refund_fee_$n_$mInt100单个退款代金券支付金额, $n为下标,$m为下标,从0开始编号
退款状态refund_status_$nString(16)SUCCESS

退款状态:

SUCCESS—退款成功

FAIL—退款失败

PROCESSING—退款处理中

CHANGE—转入代发,退款到银行发现用户的卡作废或者冻结了,导致原路退款银行卡失败,资金回流到商户的现金帐号,需要商户人工干预,通过线下或者财付通转账的方式进行退款。

退款入账账户refund_recv_accout_$nString(64)招商银行信用卡0403取当前退款单的退款入账方

1)退回银行卡:

{银行名称}{卡类型}{卡尾号}

2)退回支付用户零钱:

支付用户零钱

举例如下:

<xml>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></mch_id>
   <nonce_str><![CDATA[TeqClE3i0mvn3DrK]]></nonce_str>
   <out_refund_no_0><![CDATA[1415701182]]></out_refund_no_0>
   <out_trade_no><![CDATA[1415757673]]></out_trade_no>
   <refund_count>1</refund_count>
   <refund_fee_0>1</refund_fee_0>
   <refund_id_0><![CDATA[2008450740201411110000174436]]></refund_id_0>
   <refund_status_0><![CDATA[PROCESSING]]></refund_status_0>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <sign><![CDATA[1F2841558E233C33ABA71A961D27561C]]></sign>
   <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
</xml>

错误码

名称描述原因解决方案
SYSTEMERROR接口返回错误系统超时请尝试再次掉调用API。
REFUNDNOTEXIST退款订单查询失败订单号错误或订单状态不正确请检查订单号是否有误以及订单状态是否正确,如:未支付、已支付未退款
INVALID_TRANSACTIONID无效transaction_id请求参数未按指引进行填写请求参数错误,检查原交易号是否存在或发起支付交易接口返回失败
PARAM_ERROR参数错误请求参数未按指引进行填写请求参数错误,请检查参数再调用退款申请
APPID_NOT_EXISTAPPID不存在参数中缺少APPID请检查APPID是否正确
MCHID_NOT_EXISTMCHID不存在参数中缺少MCHID请检查MCHID是否正确
APPID_MCHID_NOT_MATCHappid和mch_id不匹配appid和mch_id不匹配请确认appid和mch_id是否匹配
REQUIRE_POST_METHOD请使用post方法未使用post传递参数 请检查请求参数是否通过post方法提交
SIGNERROR签名错误参数签名结果不正确请检查签名参数和方法是否都符合签名算法要求
XML_FORMAT_ERRORXML格式错误XML格式错误请检查XML参数格式是否正确

下载对账单

应用场景

商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。

注意:

1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中,跟原支付单订单号一致,bill_type为REVOKED;

2、微信在次日9点启动生成前一天的对账单,建议商户10点后再获取;

3、对账单中涉及金额的字段单位为“元”。

4、对账单接口只能下载三个月以内的账单。

接口链接

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

是否需要证书

不需要。

请求参数

字段名变量名必填类型示例值描述
小程序IDappidString(32)wx8888888888888888微信分配的小程序ID
商户号mch_idString(32)1900000109微信支付分配的商户号
设备号device_infoString(32)013467007045764微信支付分配的终端设备号
随机字符串nonce_strString(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串,不长于32位。推荐随机数生成算法
签名signString(32)C380BEC2BFD727A4B6845133519F3AD6签名,详见签名生成算法
签名类型sign_typeString(32)HMAC-SHA256签名类型,目前支持HMAC-SHA256和MD5,默认为MD5
对账单日期bill_dateString(8)20140603下载对账单的日期,格式:20140603
账单类型bill_typeString(8)ALL

ALL,返回当日所有订单信息,默认值

SUCCESS,返回当日成功支付的订单

REFUND,返回当日退款订单

压缩账单tar_typeString(8)GZIP非必传参数,固定值:GZIP,返回格式为.gzip的压缩包账单。不传则默认为数据流形式。

<xml>
  <appid>wx2421b1c4370ec43b</appid>
  <bill_date>20141110</bill_date>
  <bill_type>ALL</bill_type>
  <mch_id>10000100</mch_id>
  <nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>
  <sign>332F17B766FC787203EBE9D6E40457A1</sign>
</xml>

返回结果

失败时,返回以下字段

字段名变量名必填类型示例值描述
返回状态码return_codeString(16)FAILFAIL
返回信息return_msgString(128)签名失败

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

签名失败

参数格式校验错误

该日期订单未生成

成功时,数据以文本表格的方式返回,第一行为表头,后面各行为对应的字段内容,字段内容跟查询订单或退款结果一致,具体字段说明可查阅相应接口。

第一行为表头,根据请求下载的对账单类型不同而不同(由bill_type决定),目前有:

当日所有订单

交易时间,小程序ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,微信退款单号,商户退款单号,退款金额,代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率

当日成功支付的订单

交易时间,小程序ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,商品名称,商户数据包,手续费,费率

当日退款的订单

交易时间,小程序ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,退款申请时间,退款成功时间,微信退款单号,商户退款单号,退款金额,代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率

从第二行起,为数据记录,各参数以逗号分隔,参数前增加`符号,为标准键盘1左边键的字符,字段顺序与表头一致。

倒数第二行为订单统计标题,最后一行为统计数据

总交易单数,总交易额,总退款金额,总代金券或立减优惠退款金额,手续费总金额

举例如下:

交易时间,小程序ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,微信退款单号,商户退款单号,退款金额,代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率
`2014-11-1016:33:45,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1001690740201411100005734289,`1415640626,`085e9858e3ba5186aafcbaed1,`MICROPAY,`SUCCESS,`CFT,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被扫支付测试,`订单额外描述,`0,`0.60%
`2014-11-1016:46:14,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1002780740201411100005729794,`1415635270,`085e9858e90ca40c0b5aee463,`MICROPAY,`SUCCESS,`CFT,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被扫支付测试,`订单额外描述,`0,`0.60%
总交易单数,总交易额,总退款金额,总代金券或立减优惠退款金额,手续费总金额
`2,`0.02,`0.0,`0.0,`0

错误码

名称描述原因解决方案
SYSTEMERROR接口返回错误系统超时请尝试再次查询。
INVALID_TRANSACTIONID无效transaction_id请求参数未按指引进行填写参数错误,请重新检查
PARAM_ERROR参数错误请求参数未按指引进行填写参数错误,请重新检查

最新评论

猴子 发表于 2022-5-6 05:00
页面源代码音频怎样下载

一起源码让程序更轻更快

www.171739.xyz

工作时间 周一至周六 8:00-17:30

侵权处理

客服QQ点击咨询

关注抖音号

定期抽VIP

Copyright © 2016-2021 https://www.171739.xyz/ 滇ICP备13200218号

快速回复 返回顶部 返回列表