重庆互联网,19年企业互联网解决经验,专业网站开发、移动端开发、微信端开发、小程序开发!
重庆网络推广公司

微信云托管教程(九十一):微信支付-支付接口-查询退款

作者:重庆互联网小徐 发布时间:2024-02-01 浏览:24773 赞(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_idString(32)1900000109微信支付分配的子商户号
随机字符串nonce_strString(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微信退款单号
偏移量offsetInt15偏移量,当部分退款次数超过10次时可使用,表示返回的查询结果从这个偏移量开始取记录

refund_idout_refund_noout_trade_notransaction_id四个参数必填一个,如果同时存在优先级为: refund_id > out_refund_no > transaction_id > out_trade_no


重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,19年的开发经验和完善的售后服务体系获得合作客户的高度认可!

关注重庆互联网官方公众号,即可获取粉丝专享福利!

重庆互联网公众号二维码.jpg

网友留言评论
我要评论
评论

欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!

  • 赞(0
    踩(0
重庆网站定制建设
  • 重庆网站建设平台
  • 重庆网站优化公司
  • 重庆网络推广公司哪家好
  • 重庆APP制作公司
版权所有 ©2004-2024 重庆市渝中区圣灵科技信息有限公司 渝ICP备16004600号-14 渝公网安备50010802001420号 电子营业执照
重庆公众号制作哪家好
二维码
联系客服 重庆商城网站建设