> ## 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.

# 連接 PayPal 以安全收取客戶付款

> 將您的 PayPal 帳戶連結至 AgencyHandy，讓客戶使用 PayPal 這個值得信賴、全球認可的付款平台支付發票。

AgencyHandy 的 PayPal 整合為您的客戶提供安全、熟悉的付款方式，無需信用卡即可支付發票。PayPal 支援多種國際貨幣，對於服務對象遍及海外的代理商尤為實用。

<Note>
  PayPal **無法**用於追加銷售，原因為平台層級的貨幣及地區限制。如需追加銷售付款，請改用 Stripe。
</Note>

<Note>
  只有 **SuperAdmin** 和 **Admin** 角色可以連接或管理 PayPal 整合。開始前，您必須擁有一個有效的 PayPal 帳戶。
</Note>

## 連接 PayPal

<Steps>
  <Step title="開啟 PayPal 整合設定">
    登入 AgencyHandy，然後在左側側邊欄前往 **整合 → PayPal 整合**。
  </Step>

  <Step title="開始連接">
    點擊 **Connect PayPal**。系統會將您重新導向至 PayPal 的登入頁面。
  </Step>

  <Step title="授權 AgencyHandy">
    登入您的 PayPal 帳戶並檢閱所要求的權限。點擊 **Allow**（或 **Grant**）以授權 AgencyHandy 存取您的帳戶。
  </Step>

  <Step title="確認連接">
    成功授權後，PayPal 會將您重新導向回 AgencyHandy。整合卡片上將出現確認訊息 — **PayPal Connected**。客戶現在可以使用 PayPal 支付發票。
  </Step>
</Steps>

## 客戶如何透過 PayPal 付款

整合啟用後，您發送的任何發票上都會出現 **Pay with PayPal** 按鈕。您的客戶點擊該按鈕，登入其 PayPal 帳戶（或視地區而定以訪客身份付款），即可完成付款。PayPal 確認付款後，AgencyHandy 會自動更新發票狀態。

## 支援的貨幣

AgencyHandy 支援以下貨幣進行 PayPal 付款：

| 地區      | 貨幣                                          |
| ------- | ------------------------------------------- |
| 美洲      | USD, CAD, BRL, MXN                          |
| 歐洲      | EUR, GBP, CHF, NOK, SEK, DKK, PLN, CZK, HUF |
| 亞太地區    | AUD, NZD, JPY, HKD, SGD, MYR, PHP, THB, TWD |
| 中東 / 其他 | ILS, CNY                                    |

<Warning>
  部分貨幣有所限制：

  * **JPY** 及少數其他貨幣不支援小數金額 — 請避免在發票總額中使用零碎金額。
  * **BRL** 僅適用於巴西 PayPal 帳戶。若您的帳戶並非設於巴西，BRL 付款將自動轉換為您的主要貨幣。
  * 特定貨幣僅適用於當地帳戶。請確認您帳戶的持有貨幣與發票貨幣一致，以避免錯誤。
</Warning>

<Note>
  當發生貨幣兌換時，PayPal 會收取其自有的兌換費用和匯差。這些費用不受 AgencyHandy 控制。
</Note>

## 測試整合

在將 PayPal 用於真實客戶發票之前，請先進行快速測試：

1. 在 AgencyHandy 中使用[支援的貨幣](#supported-currencies)建立一張測試發票。
2. 將發票傳送至您控制的另一個 PayPal 帳戶。
3. 從該帳戶完成付款。
4. 返回 AgencyHandy，確認發票狀態已更新為 **Paid**，並確認款項已出現在您的 PayPal 帳戶中。