> ## 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>
  Подключать интеграцию с PayPal и управлять ею могут только пользователи с ролью **SuperAdmin** и **Admin**. Перед началом у вас должен быть активный аккаунт PayPal.
</Note>

## Подключение PayPal

<Steps>
  <Step title="Откройте настройки интеграции с PayPal">
    Войдите в AgencyHandy, затем перейдите в **Интеграции → Интеграция с PayPal** в левой боковой панели.
  </Step>

  <Step title="Начните подключение">
    Нажмите **Подключить PayPal**. Вы будете перенаправлены на страницу входа PayPal.
  </Step>

  <Step title="Авторизуйте AgencyHandy">
    Войдите в свой аккаунт PayPal и ознакомьтесь с запрашиваемыми разрешениями. Нажмите **Разрешить** (или **Предоставить доступ**), чтобы авторизовать AgencyHandy для доступа к вашему аккаунту.
  </Step>

  <Step title="Подтвердите подключение">
    После успешной авторизации PayPal перенаправит вас обратно в AgencyHandy. На карточке интеграции появится сообщение **PayPal подключён**. Теперь клиенты могут оплачивать счета через PayPal.
  </Step>
</Steps>

## Как клиенты платят через PayPal

После активации интеграции на каждом отправленном вами счёте появится кнопка **Оплатить через PayPal**. Клиент нажимает кнопку, входит в свой аккаунт PayPal (или оплачивает как гость, в зависимости от региона) и завершает платёж. AgencyHandy автоматически обновляет статус счёта после подтверждения платежа от PayPal.

## Поддерживаемые валюты

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, используя [поддерживаемую валюту](#поддерживаемые-валюты).
2. Отправьте счёт на вторичный аккаунт PayPal, которым вы управляете.
3. Выполните оплату со вторичного аккаунта.
4. Вернитесь в AgencyHandy и убедитесь, что статус счёта обновился до **Оплачен** и что средства отображаются в вашем аккаунте PayPal.