> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.mixin.one/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 如何使用升级工具完成 TIP 升级（API 错误 20118）

因 2024 年底 [Mixin API 升级](/zh/article/mixin-api-l4jruq/)，部分未升级 TIP 的用户可能在登录 Mixin Messenger 时遇到错误（如错误码 20118）。我们已推出专用升级工具，帮助您完成账户升级并恢复正常使用。

本指南将引导您使用该工具完成升级，并重新登录 Mixin Messenger。

### 一、使用工具完成升级（TIP 升级）

1. 打开工具页面

请在手机或电脑浏览器中访问： [Mixin 旧网络 PIN 升级](https://legacy.mixin.one)页面。

2. 输入电话号码

||| 请按照📱  `+国家代码+手机号` ，例如：中国号码输入 `+8613800138000`

3. 输入您收到的验证码

系统会向您输入的手机号发送验证码，请正确填写。

4. 输入正确的 PIN

输入您曾用于该账号的 PIN，请确保输入正确。
| 如果您不确定 PIN 是哪个，建议直接写下来尝试的组合，避免重复尝试！

5. 操作完成，页面会显示您已经完成升级的提示

系统验证成功后，会提示您已完成升级。

### 二、重新登录 Mixin Messenger

||| 请删除当前安装的 Mixin，重新下载后登录
 
1. 下载并安装最新版本的 Mixin Messenger

**📱 Android 用户：**
* [访问官网下载安装 APK](https://messenger.mixin.one/download) 
* 或通过 [Google Play Store](https://play.google.com/store/apps/details?id=one.mixin.messenger)  安装

**📱 iOS 用户：**
* 请使用非中国大陆、非英国地区的 Apple ID，通过 [App Store](https://apps.apple.com/app/mixin/id1322324266) 安装
| 如果遇到问题，可以访问帮助文档[如何下载或更新 Mixin Messenger？](https://support.mixin.one/zh/article/mixin-messenger-s83ghx/)

2. 登录 Mixin Messenger

输入您的手机号和验证码登录账号。

3. 完成 TIP 设置

登录后系统会提示您设置 TIP 密码（PIN）。您可以输入新密码，也可使用之前的 PIN。请注意：
* 设置过程会重复输入多次 PIN，请确保一致。
* 该 PIN 非常重要，请务必妥善保管。

4. 完成

恭喜您，现在可以正常使用 Mixin Messenger，包括转账、交易等功能。

|| 如果您还未迁移资产可以参考文档 [如何把资产从旧钱包迁移至新钱包？](/zh/article/5aac5l2v5oqk6lwe5lqn5luo5pen6zkx5yyf6lb56e76iez5paw6zkx5yyf77yf-my2a1e/) 进行迁移操作。另外，迁移操作增加了审核机制，大概需要 3-4 天后才会入账新系统钱包，请您耐心等待。

---

### 三、常见问题解答（FAQ）

1. 打不开升级工具页面怎么办？

建议尝试以下方式：

* 更换网络（Wi-Fi 或流量）
* 使用 VPN 重试

2. 输入手机号点发送验证代码后，页面提示 `Failed to fetch` 怎么办？

这个也是网络问题，请您尝试：

* 更换网络（Wi-Fi 或流量）
* 使用 VPN 重试

3. 工具页面输入了错误 PIN 怎么办？

* 您共有 **9 次尝试机会**。超过后页面将提示 `Error 403`  或者 `Forbidden`，该账号将被 **锁定 30 天**。
* 请耐心等待锁定期结束再尝试，期间请勿反复操作。
||| 每登录输入一次验证码也会消耗一次机会，切勿重复刷新页面登录账号！

4. 忘记 PIN 了怎么办？

PIN 是无法找回的，您只能通过尝试回忆的方式找回。请务必谨慎操作，避免锁定。
| 建议您写下每次尝试的 PIN，避免重复尝试浪费次数。

5. 手机号无法使用了怎么办？

* 若未设置紧急联系人：建议您联系通讯运营商恢复手机号后再操作。
* 若已设置过恢复联系人（原“紧急联系人”）：目前工具暂不支持此方式登录。请联系官方客服：
  App 内私聊 Team Mixin（@7000）
  或点击网页浮窗联系客服说明情况，我们将后续协助您处理。

6. 用完工具后登录 Mixin 输入 PIN 还提示错误怎么办？

建议您等待 7 天后再次尝试