Оплата через PayPal и PayPal.me

PayPal или PayPal.me – в чём разница

• PayPal (онлайн): клуб один раз подключает свой счёт PayPal в панели управления. Участник нажимает в WebApp или приложении «Оплатить через PayPal», платит на странице PayPal, и оплата автоматически записывается на его счёт – с чеком в PDF по e-mail.
• PayPal.me (ссылка на оплату): клуб указывает только адрес вида https://paypal.me/club/{amount}EUR. Участник получает кнопку, которая открывает PayPal с уже подставленной суммой. Мы об оплате ничего не узнаём – кассир видит её в PayPal и рассчитывает счёт вручную.
• Рекомендация: PayPal (онлайн), если кассир не должен ничего вносить вручную. PayPal.me, если клуб не хочет создавать приложение в PayPal Developer и ручная запись допустима.
• Можно использовать оба способа одновременно. Тогда участник видит обе кнопки.

Что нужно

• Счёт PayPal для клуба. Для PayPal (онлайн) также доступ к PayPal Developer, чтобы создать там приложение; какой тип счёта для этого нужен, определяет PayPal.
• Доступ владельца или администратора клуба в панели управления /admin – только эти роли могут менять платёжные доступы и ссылку на оплату.
• Для расчёта оплат PayPal.me: доступ с правом принимать оплату в панели управления, в WebApp или приложении.

Подключить PayPal (онлайн) к клубу

1. Войдите в PayPal Developer и откройте «Apps & Credentials». Создайте там приложение и скопируйте Client ID и Secret.
2. Откройте /admin, выберите слева клуб и перейдите в «Договор и платежи» → «Онлайн-оплата».
3. Введите Client ID и Client Secret в карточке «PayPal». Чтобы попробовать без реальных денег, отметьте «Sandbox (тестовая среда)» и используйте данные sandbox.
4. Нажмите «Проверить и сохранить». Мы сразу входим в PayPal с этими данными; если всё работает, карточка показывает «Готово» (в тесте ещё «Тестовый режим»). Данные хранятся в зашифрованном виде.
5. Позже новые данные вводятся так же, затем «Заменить доступ». «Убрать» удаляет данные; участники больше не смогут платить через PayPal.

Что делают участники – PayPal (онлайн)

1. Участник открывает приложение на своём телефоне – планшет клуба не нужен –, переходит к своему счёту и нажимает «Оплатить». Кнопка появляется, только если есть задолженность. Если вместо этого написано «У тебя пока нет счёта участника в этом списке», его вход не связан ни с одним счётом списка: укажите его e-mail у счёта в «Управлении» в разделе «Журналы и счета» → «Счета».
2. В окне «Оплатить задолженность» он нажимает «Оплатить через PayPal». Открывается страница PayPal – в WebApp в том же окне, в приложении на iPhone, iPad и Android в браузере устройства (Safari или Chrome).
3. Там он входит в PayPal и подтверждает оплату. Оплачивается вся задолженность, плюс пожертвование с округлением, если клуб его предлагает и участник его выбрал.
4. Затем он возвращается в приложение. Там написано «Спасибо! Оплата получена и записана.», и баланс закрыт.

Когда записывается – PayPal (онлайн)

• Деньги списываются только тогда, когда мы завершаем одобренную в PayPal оплату. Перед этим мы сверяем сумму и валюту с задолженностью – если что-то не совпадает, ничего не списывается.
• Это происходит сразу, когда участник возвращается. Если он не вернулся, проверка каждые пять минут завершает оплату. Webhook для PayPal не нужен.
• Страница оплаты действует 23 часа. Если участник начинает новую оплату, старая больше не действует. Если он отменяет, ничего не записывается.
• После записи участник получает чек расчёта в PDF по e-mail. В /admin оплата видна в «Журналы и счета» → «Журнал платежей» со способом «PayPal» и номером PayPal в «Документ провайдера».

Указать ссылку PayPal.me

1. Откройте /admin, выберите клуб и перейдите в «Договор и платежи» → «Банковские реквизиты и GiroCode».
2. В разделе «Ссылка на оплату (например, PayPal.me)» впишите в «Надпись на кнопке», например, PayPal.
3. В качестве адреса укажите свою ссылку, например https://paypal.me/club/{amount}EUR. {amount} обязателен – туда подставляется задолженность с точкой (12.50); {currency} подставляет валюту. Адрес должен начинаться с https://.
4. Ниже пример показывает готовую ссылку. Нажмите на неё, чтобы проверить.
5. Нажмите «Сохранить ссылку на оплату». «Убрать» снова убирает кнопку из приложения.

Что делают участники – PayPal.me

1. Участник нажимает в WebApp или приложении «Оплатить». В окне есть кнопка «Оплатить через PayPal» – с надписью, которую вы указали, без надписи «Оплатить онлайн».
2. Кнопка открывает PayPal с суммой задолженности. Участник платит там.
3. В WebApp или приложении добавлено: «Оплата отобразится, как только её учтёт кассир.» До этого сумма остаётся долгом.

Записать оплату PayPal.me вручную

1. Проверьте в своём счёте PayPal, кто и сколько заплатил.
2. В /admin откройте список и перейдите в «Журналы и счета» → «Счета». Нажмите «Принять оплату» в строке участника.
3. Введите сумму, которую показывает PayPal. В качестве способа оплаты выберите «Банковский перевод» – способа «PayPal» при ручном приёме нет – и напишите в «Заметка», например, «PayPal.me».
4. Нажмите «Рассчитать». Участник получает чек в PDF по e-mail. В WebApp или приложении то же самое делается через «Принять оплату» на счёте.

Полезно знать

• Ссылка PayPal.me содержит только сумму, без назначения платежа. Сопоставлять оплату приходится по имени плательщика в PayPal.
• Сумма в ссылке PayPal.me – это задолженность на момент открытия окна. То, что добавится позже, остаётся долгом.
• Возврат денег в PayPal у нас автоматически не сторнируется – счёт участника остаётся рассчитанным. Такие случаи уточняйте с участником.
• Комиссию PayPal вы видите в своём счёте PayPal; в столбце «Комиссия» в «Журнал платежей» её нет.
• «Оплата по e-mail» на счёте содержит ссылку на оплату, если настроен онлайн-провайдер, – если настроен и SumUp, то ссылку SumUp. Ссылки PayPal.me в письме не бывает.
• После переезда из старого приложения: указанная там ссылка на оплату переносится и называется «PayPal (Altsystem)» – проверьте надпись и адрес в «Банковские реквизиты и GiroCode» (в нём должен быть {amount}). Подключение PayPal старого приложения не переносится: для PayPal (онлайн) заново введите Client ID и Secret.

Если что-то не получается

• «Проверить и сохранить» не проходит: Client ID и Secret неверны или относятся к другой среде. Данные sandbox – только с отметкой «Sandbox (тестовая среда)», рабочие – только без неё.
• Участник не видит «Оплатить через PayPal»: задолженности нет, или PayPal в «Онлайн-оплата» не в состоянии «Готово».
• Оплата появилась не сразу: участник не вернулся в приложение. Проверка запишет её в течение нескольких минут.
• При сохранении ссылки появляется «Отсутствует {amount} — туда подставляется сумма долга» или «Введите полный адрес https://»: укажите адрес с https:// и {amount}.
• Участник заплатил по PayPal.me, а до вашей записи ещё и онлайн: всё равно запишите оплату PayPal.me – сумма станет кредитом на его счёте.