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

# 連接 Stripe 以在 AgencyHandy 中接受線上付款

> 將您的 Stripe 帳戶連接到 AgencyHandy，透過您在平台內發送的發票直接向客戶收取安全的線上付款。

AgencyHandy 的 Stripe 整合讓您可以透過平台內發送的發票，直接從您的客戶收取信用卡付款。連接後，您的客戶將看到熟悉的 Stripe 託管結帳介面，付款狀態會自動同步回 AgencyHandy——無需手動對帳。

<Note>
  只有 **超級管理員** 和 **管理員** 角色才能連接或管理 Stripe 整合。在開始之前，您還必須擁有一個已驗證的 Stripe 帳戶並具備適當的權限。
</Note>

## 連接 Stripe

<Steps>
  <Step title="開啟 Stripe 整合設定">
    在左側邊欄中，導覽至 **整合 → Stripe 整合**。
  </Step>

  <Step title="在 Stripe 上授權">
    點擊 **連接 Stripe**。您將被重新導向至 Stripe 的授權頁面。登入您的 Stripe 帳戶，然後點擊 **允許** 以授予 AgencyHandy 存取權限。核准後，Stripe 會自動將您重新導向回 AgencyHandy。
  </Step>

  <Step title="設定付款偏好">
    重新導向後，設定以下選項：

    * **貨幣** — 選擇您工作區的預設計費貨幣。
    * **付款方式** — 根據您的 Stripe 帳戶支援情況，啟用或停用卡片類型（Visa、Mastercard 等）。
    * **計費偏好** — 可選擇設定稅率、發票前綴或預設付款條款和到期日。
  </Step>

  <Step title="儲存並確認">
    點擊 **儲存**。整合啟用後會出現確認橫幅。Stripe 現在已連接到您的工作區，您的客戶可以線上支付發票。
  </Step>
</Steps>

## 測試整合

在發送正式發票之前，執行快速的端對端測試，以確認連接是否正常運作。

<Steps>
  <Step title="建立測試發票">
    在 AgencyHandy 中建立一張草稿發票，並設定少量金額。
  </Step>

  <Step title="傳送給自己">
    將發票傳送到您自己的電子郵件地址，或傳送給可以協助測試的團隊成員。
  </Step>

  <Step title="完成測試付款">
    開啟發票連結，如果您的 Stripe 帳戶處於測試模式，請使用 Stripe 測試卡（例如 `4242 4242 4242 4242`）完成付款；如果是正式模式，請使用真實卡片。
  </Step>

  <Step title="確認狀態更新">
    返回 AgencyHandy，確認發票狀態已變更為 **已付款**。如果已變更，表示您的整合正常運作。
  </Step>
</Steps>

## 管理您的 Stripe 連接

隨時返回 **整合 → Stripe 整合** 以：

* **更新付款設定** — 變更貨幣、付款方式或計費偏好。
* **查看連接狀態** — 確認 Stripe 目前是否處於活躍狀態。
* **中斷連接** — 點擊 **中斷連接** 以取消連結您的 Stripe 帳戶。付款收取將立即暫停，直到您重新連接。
* **重新連接** — 再次點擊 **連接 Stripe** 並重新授權以恢復整合。

<Warning>
  中斷連接 Stripe 會暫停所有未付發票的付款收取。在您重新連接並重新授權之前，客戶將無法線上付款。
</Warning>

## 其他注意事項

<Note>
  AgencyHandy 從不儲存您的付款憑證。所有付款資料均由 Stripe 的安全基礎架構專門處理。
</Note>

* **每個工作區一個帳戶** — 您只能將單一 Stripe 帳戶連接到每個 AgencyHandy 工作區。若要切換帳戶，請先中斷目前帳戶的連接，然後再使用新帳戶重新連接。
* **即時發票狀態** — 所有連結到 Stripe 的發票將繼續反映直接從 Stripe 收到的即時狀態更新。
* **貨幣** — 確保 AgencyHandy 中設定的貨幣與您的 Stripe 帳戶中啟用的貨幣相符，以避免付款錯誤。