---
url: "https://pay.weixin.qq.com/doc/v2/partner/4011989264.md"
title: "转换短链接"
doc_id: 4011989264
---

>更新时间：2024.08.08

### 应用场景

该接口主要用于扫码原生支付模式一中的二维码链接转成短链接(weixin://wxpay/s/XXXXXX)，减小二维码数据量，提升扫描速度和精确度。

### 接口地址

https://api.mch.weixin.qq.com/tools/shorturl

### 是否需要证书

否

### 请求参数

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 服务商商户的APPID | appid | 是 | String(32) | wx8888888888888888 | 服务商商户的APPID |
| 商户号 | mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的商户号 |
| 子商户公众账号ID | sub\_appid | 否 | String(32) | wx8888888888888888 | 微信分配的子商户公众账号ID |
| 子商户号 | sub\_mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的子商户号 |
| URL链接 | long\_url | 是 | String(512) | weixin：//wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch\_id=XXXXX&product\_id=XXXXXX&time\_stamp=XXXXXX&nonce\_str=XXXXX | 需要转换的URL，签名用原串，传输需URL encode |
| 随机字符串 | nonce\_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名，详见[签名生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |

### 返回结果

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 返回状态码 | return\_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL<br>此字段是通信标识，非交易标识，交易是否成功需要查看trade\_state来判断 |
| 返回信息 | return\_msg | 是 | String(128) | OK | 当return\_code为FAIL时返回信息为错误原因 ，例如<br>签名失败<br>参数格式校验错误 |

以下字段在return\_code为SUCCESS的时候有返回

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 服务商的APPID | appid | 是 | String(32) | wx8888888888888888 | 服务商商户的APPID |
| 商户号 | mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的商户号 |
| 子商户公众账号ID | sub\_appid | 否 | String(32) | wx8888888888888888 | 微信分配的子商户公众账号ID |
| 子商户号 | sub\_mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的子商户号 |
| 随机字符串 | nonce\_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名，详见[签名生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |
| 业务结果 | result\_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 错误代码 | err\_code | 否 | String(32) | SYSTEMERROR | SYSTEMERROR—系统错误<br>URLFORMATERROR—URL格式错误 |
| URL链接 | short\_url | 是 | String(64) | weixin：//wxpay/s/XXXXXX | 转换后的URL |

### 错误码

| 名称 | 描述 | 原因 | 解决方案 |
| --- | --- | --- | --- |
| SIGNERROR | 签名错误 | 参数签名结果不正确 | 请检查签名参数和方法是否都符合签名算法要求 |
| REQUIRE\_POST\_METHOD | 请使用post方法 | 未使用post传递参数 | 请检查请求参数是否通过post方法提交 |
| APPID\_NOT\_EXIST | APPID不存在 | 参数中缺少APPID | 请检查APPID是否正确 |
| MCHID\_NOT\_EXIST | MCHID不存在 | 参数中缺少MCHID | 请检查MCHID是否正确 |
| APPID\_MCHID\_NOT\_MATCH | appid和mch\_id不匹配 | appid和mch\_id不匹配 | 请确认appid和mch\_id是否匹配 |
| LACK\_PARAMS | 缺少参数 | 缺少必要的请求参数 | 请检查参数是否齐全 |
| XML\_FORMAT\_ERROR | XML格式错误 | XML格式错误 | 请检查XML参数格式是否正确 |
| POST\_DATA\_EMPTY | post数据为空 | post数据不能为空 | 请检查post数据是否为空 |