# 微信支付 - 通过商户退款单号查询单笔退款

该接口方法需要安装 小程序微信支付能力，如未安装需要前往安装才可以使用

# 接口英文名

wxpay_refund_query

注意：该接口仅支持在服务端调用

# 调用方式

# 1. 使用云函数在服务端调用查询退款接口

模板已内置了云函数代码，可以直接在微信开发者工具中下载到本地修改后使用。 也可以手动创建云函数来完成，点击在线代码示例，可以查看云函数示例代码。

• 下载模板云函数代码到本地

打开微信开发者工具界面，在cloudfunctions目录点击右键，选择同步云函数列表，同步模板中的云函数wxpayFunctions到本地；然后在云函数wxpayFunctions目录右键，选择下载，即可下载模板内置的云函数代码到本地。如下图所示：

• 编辑下单云函数

修改云函数wxpayFunctions下的wxpay_refund_query/index.js代码，参数更新为业务实际参数。云函数编辑后，需要重新部署。

# 2. 小程序端调用云函数查询退款

小程序端调用云函数时，需要先在小程序端初始化云能力。修改app.js，在 App的 onLaunch 生命周期方法中添加云能力初始化代码，参数传入用户的云开发环境ID。

App({
  onLaunch: function () {
    wx.cloud.init({
      // env 参数决定接下来小程序发起的云开发调用（wx.cloud.xxx）会默认请求到哪个云环境的资源
      env: '{%TCB_ENV_ID%}',
      // 是否在将用户访问记录到用户管理中，在控制台中可见，默认为false
      traceUser: false,
    });
  },
});

小程序中调用步骤 1 中的云函数，查询订单。

// 小程序代码
wx.cloud.callFunction({
  // 云函数名称
  name: 'wxpayFunctions',
  data: {
    // 调用云函数中的退款查询方法
    type: 'wxpay_refund_query',
    // 业务其他参数...
  },
  success: (res) => {
    console.log('查询退款结果: ', res);
  },
});

# 更多说明

错误码请参考查询单笔退款

# 入参:

# 出参: