---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012072514.md"
title: "小程序左上角返回键管理"
doc_id: 4012072514
---

>更新时间：2025.02.19

服务商可根据服务商维度、特约商户维度，订单号维度配置该接口



## 接口说明

支持商户：【普通服务商】【渠道商】

## 请求参数

`payCompletedPageOptions.showNavBackButton`  选填 boolean

【是否显示支付回调页左上角返回按钮】 是否显示左上角返回按钮，默认是true

显示和隐藏左上角返回按钮

```
wx.requestPayment({
    payCompletedPageOptions: {
        showNavBackButton: false // 是否显示左上角返回按钮，默认是 true
    }
})
```

左上角返回按钮跳转页面配置

```
wx.requestPayment({
    payCompletedPageOptions: {
        showNavBackButton: true
    },
    success: res => {
        res.payCompletedPage.onUnload(() => {
                wx.navigateTo({
                        url: '/page/index/index' // 点击左上角返回按钮，会触发支付回调页onUnload 事件，在 onUnload 事件触发时可以跳转到别的页面
                })
        })
    }
})
```

## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012082324.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | INVALID\_REQUEST | 服务商未开通点金计划 | 请在服务商平台先行开通点金计划后再试 |
| 400 | INVALID\_REQUEST | 服务商被处罚中 | 请在服务商平台处理处罚后再试 |
| 400 | INVALID\_REQUEST | 特约商户被处罚中 | 请让特约商户在商户平台处理处罚后再试 |
| 400 | MCH\_NOT\_EXISTS | 特约商户号不存在 | 特约商户号不存在，请确认特约商户号准确性 |
| 400 | PARAM\_ERROR | 参数错误 | 根据错误提示，传入正确参数 |
| 500 | SYSTEM ERROR | 系统繁忙，请稍后重试 | 5开头错误码都为系统问题，请使用相同参数稍后重新调用 |
| 500 | OPERATION\_FAILED | 请求操作失败，请稍后重试 | 5开头错误码都为系统问题，请使用相同参数稍后重新调用 |
| 401 | SIGN\_ERROR | 签名验证失败 | 5开头错误码都为系统问题，请使用相同参数稍后重新调用 |
| 400 | INVALID\_REQUEST | 操作失败 | 操作失败，请稍后重试 |