Старое API

Устарело

Внимание: в связи с масштабным обновлением плагина «Онлайн-Лейка» инструкция ниже может отличаться от существующего интерфейса. В ближайшее время инструкция будет обновлена.

1. Зарегистрируйте ваш бизнес-аккаунт в PayPal. О процессе регистрации вы можете прочитать здесь.

2. Далее, зайдите на портал разрабочиков PayPal: https://developer.paypal.com/
Для входа используйте вашу почту и пароль, которые вы указали при регистрации.

3. После процедуры входа войдите в раздел Dashboard и передите на страницу Sandbox -> Accounts.

4. Если у вас ещё нет тестовых аккаунтов PayPal, нажмите «Create account».

5. Далее вы сможете использовать пару тестовых аккаунтов: бизнес- (BUSINESS) и персональный (PERSONAL). Первый мы будем использовать для настройки Лейки, второй — для совершения тестовых платежей.

6. Зайдите в раздел Profile -> API Credentials вашего тестового бизнес-аккаунта. Скопируйте значения параметров Username, Password и Signature в поля настроек PayPal в Лейке — соответственно, в поля «Имя пользователя API PayPal«, «Пароль для API PayPal«, «Подпись для API PayPal«. Сохраните настройки Лейки.

7. Войдите в панель управления вашего тестового бизнес-аккаунта PayPal. Важно: для входа используйте почту и пароль вашего тестового бизнес-аккаунта!

8. Перейдите к настройкам уведомлений о платежах: Профиль -> Дополнительные функции -> Мои инструменты продаж. Нажмите «обновить» напротив пункта «Уведомления о мгновенных платежах».

9. Если уведомления выключены, нажмите кнопку «изменить параметры».

10. В поле «» укажите следующий адрес: https://your-website.org/leyka/service/paypal/ipn/ (здесь https://your-website.org/ — корневой адрес вашего сайта).

В поле «IPN-сообщения» выберите «Принимать IPN-сообщения (Включено)».

Сохраните настройки уведомлений.

На этом настройка завершена. Добавьте PayPal на вашу платёжную форму в разделе «Лейка -> Настройки -> Платёжные системы» и проведите тестовый платёж с помощью тестового персонального аккаунта. 

Новое API

В Лейке доступно с версии 3.4.

В PayPal:

  1. Зарегистрируйте ваш бизнес-аккаунт в PayPal. О процессе регистрации вы можете прочитать здесь.
  2. Далее, зайдите на портал разрабочиков PayPal: https://developer.paypal.com/ (Login into dashboard). Для входа используйте вашу почту и пароль, которые вы указали при регистрации.
  3. После процедуры входа войдите в раздел Dashboard и передите на страницу Sandbox -> Accounts.
  4. Если у вас ещё нет тестовых аккаунтов PayPal, зайдите в «Create account».
  5. Далее вы сможете использовать пару тестовых аккаунтов: бизнес- (BUSINESS) и персональный (PERSONAL). Первый мы будем использовать для настройки Лейки, второй — для совершения тестовых платежей.
  6. Зайдите в раздел Dashboard -> My Apps & Credentials и создайте новое приложение. Для этого нужно указать название и выбрать бизнес-аккаунт.
  7. Добавьте вебхук. Адрес https://your-site/leyka/service/paypal/handle-webhook/, все события (Events tracked: All events). URL должен начинаться с HTTPS (т.е. быть с SSL-сертификатом).
  8. Отредактируйте настройки:
  • отметьте чекбокс Accept payments
  • если в вашем аккаунте PayPal поддерживаются рекуррентные платежи, то разверните также Advanced options и отметьте пункт Billing agreements
  • отметьте чекбокс Connect with PayPal (formerly Log In with PayPal)
  • отметьте чекбокс Transaction Search

Сохраните настройки.

В Лейке:

  1. Отметьте чекбокс «Использовать REST API»
  2. Скопируйте данные аккаунта и вставьте в настройки Лейки (Client ID, Secret, ID вебхука).
  3. Сделайте тестовый платёж (статус пожертвования в Лейке должен дойти до «Оплачено»).

Боевой режим

Чтобы переключиться на боевой режим, перейдите на страницу Dashboard в PayPal. Зайдите в своё приложение, переключитесь на вкладку Live, при необходимости снова добавьте вебхук и отредактируйте настройки.

Данные боевого аккаунта PayPal (Client ID, Secret, ID вебхука) вставьте в настройки Лейки.

После обновления данных уберите чекбокс «Тестовый режим интеграции» в настройках Лейки.

Рекуррентные платежи можно подключить через обращение в поддержку PayPal. Когда опция будет включена, поставьте соответствующий чекбокс в настройках Лейки («Доступны ежемесячные рекуррентные пожертвования»).