> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 行動端配對

> 透過 QR Code 把行動錢包連接到 Intention Exchange，以及配對失敗時該怎麼辦。

本頁講的是行動端配對流程：你在桌面瀏覽器裡打開交易所，畫面顯示一組 QR Code，用手機上的錢包應用程式掃過去，簽章會話就建立起來了。

<h2 id="the-normal-flow">
  正常流程
</h2>

1. 在桌面瀏覽器中點擊「Connect wallet」，選擇行動端配對方式。
2. 畫面顯示一組 QR Code，有效時間很短。
3. 打開手機上的錢包應用程式，用錢包內建的掃描器，不要用系統相機；除非你的錢包支援從相機應用程式喚起深層連結。
4. 在錢包中批准彈出的配對請求。
5. 桌面那個分頁會切換到已連線狀態，接著要求一次[會話簽章](/zh-Hant/help/session-signature)。

<h2 id="common-failure-modes">
  常見故障
</h2>

**相機打不開。** 你的錢包應用程式沒有相機權限。到作業系統設定裡開啟權限，再試一次。iOS 上位於 設定 → 隱私權 → 相機；Android 上位於 應用程式資訊 → 權限。

**你還沒來得及掃，QR Code 就過期了。** 出於安全考量，這些 QR Code 存活時間很短。在桌面那一側點「refresh」或「show new code」，再盡快掃新的那一組。

**錢包提示「配對失敗」，或者乾脆毫無反應。** 配對協議要靠一台中繼伺服器，而兩邊的裝置都必須連得到。如果你的手機連著企業 Wi-Fi、飯店網路，或者用了會封鎖對外 WebSocket 流量的 VPN，中繼就永遠收不到手機的訊息。把手機切到行動網路，或換一個網路再試。

**配對成功了，但每個操作都失敗。** 會話確實連上了，但簽章路徑上有環節壞了。常見的原因有三個：錢包配對到了錯的帳戶；錢包不支援這套會話簽章方案（更新錢包）；或者手機休眠，中繼連線在背景斷掉了。從錢包那一側解除配對，重新打開錢包，再完整走一遍流程。

<h2 id="what-to-send-us-if-none-of-this-works">
  如果以上都無效，該發什麼給我們
</h2>

請寄到 `contact@intention.xyz`，附上：

* 你的行動錢包名稱和版本。
* 手機的作業系統及版本。
* 桌面瀏覽器及版本。
* 手機上顯示的錯誤畫面照片或截圖。
* 你嘗試配對的大致 UTC 時間。

我們可以用這個時間去比對中繼日誌，看握手是在哪一步失敗的。
