作者:重庆互联网小徐 发布时间:2024-02-01 浏览:25074 赞(3679) 收藏 评论(0)
使用本接口需要开启开放接口服务
提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,用零钱支付的退款20分钟内到账,银行卡支付的退款3个工作日后重新查询退款状态。
注意:如果单个支付订单部分退款次数超过20次请使用退款单号查询
http://api.weixin.qq.com/_/pay/queryrefund
当一个订单部分退款超过10笔后,商户用微信订单号或商户订单号调退款查询API查询退款时,默认返回前10笔和total_refund_count(退款单总笔数)。商户需要查询同一订单下超过10笔的退款单时,可传入订单号及offset来查询,微信支付会返回offset及后面的10笔,以此类推。当商户传入的offset超过total_refund_count,则系统会返回报错PARAM_ERROR。
举例:
一笔订单下的退款单有36笔,当商户想查询第25笔时,可传入订单号及offset=24,微信支付平台会返回第25笔到第35笔的退款单信息,或商户可直接传入退款单号查询退款
{ "out_trade_no":"2021WERUN1647840687637", "sub_mch_id":"1712734762"}
{ "errcode":0, "errmsg":"ok", "respdata":{ "return_code":"SUCCESS", "return_msg":"OK", "result_code":"SUCCESS", "appid":"wxd2565e6a04246fd1", "mch_id":"1800780001", "sub_mch_id":"1712734762", "nonce_str":"O3Ko2eAjgqFLuvXL", "sign":"278E0B62A3FF3218265A11C0C7DD5641", "transaction_id":"4200136120742200032130860688", "out_trade_no":"2021WERUN1647840687637", "total_fee":1, "cash_fee":1, "refund_count":1, "out_refund_no_list":[], "refund_id_list":[], "refund_channel":[], "refund_fee_list":[], "settlement_refund_fee_list":[], "coupon_type_array":[], "coupon_refund_fee_list":[], "coupon_refund_count_list":[], "coupon_refund_id_array":[], "coupon_refund_fee_array":[], "refund_status_list":[], "refund_account_list":[], "refund_recv_accout_list":[], "refund_success_time_list":[] }}
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
子商户号 | sub_mch_id | 是 | String(32) | 1900000109 | 微信支付分配的子商户号 |
随机字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串,不长于32位。推荐随机数生成算法 |
微信订单号 | transaction_id | 四选一 | String(28) | 1217752501201407033233368018 | 微信订单号查询的优先级是: refund_id > out_refund_no > transaction_id > out_trade_no |
商户订单号 | out_trade_no | 四选一 | String(32) | 1217752501201407033233368018 | 商户系统内部订单号,要求32个字符内,只能是数字、大小写字母_- |
商户退款单号 | out_refund_no | 四选一 | String(64) | 1217752501201407033233368018 | 商户系统内部的退款单号,商户系统内部唯一,只能是数字、大小写字母_- |
微信退款单号 | refund_id | 四选一 | String(32) | 1217752501201407033233368018 | 微信退款单号 |
偏移量 | offset | 否 | Int | 15 | 偏移量,当部分退款次数超过10次时可使用,表示返回的查询结果从这个偏移量开始取记录 |
refund_id
、out_refund_no
、out_trade_no
、transaction_id
四个参数必填一个,如果同时存在优先级为: refund_id
> out_refund_no
> transaction_id
> out_trade_no
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,19年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!