PayPal Expanded Checkout

Чтобы использовать модуль оплаты PayPal Expanded Checkout, выполните настройки на стороне платёжной системы и подключите модуль в Clouden.

Поддержка способов оплаты
Банковские карты	Наличные	Электронные кошельки	Мобильные платежи	Интернет-банкинг

American Express, Discover, Mastercard, Visa.		PayPal Wallet	Apple Pay, Google Pay	Локальные способы оплаты (например, BLIK, iDEAL, Sofort)
Поддерживаемые возможности
Поддержка ФЗ-54	Возврат платежей	Рекуррентные платежи		Подписки

Особенности работы

Поддерживается тестовый режим работы. Подробнее см. документацию Paypal.

Настройка на стороне платежной системы

Для интеграции с Clouden создайте новое приложение на стороне PayPal:

Авторизуйтесь в личном кабинете PayPal.
Перейдите в раздел Dashboard → REST API apps и нажмите Create App. Для настройки интеграции на стороне Clouden скопируйте значения из полей Client ID и Secret .
Настройте webhook:
1. Перейдите в настройки созданного приложения и найдите раздел Webhooks.
2. Нажмите Add Webhook.
3. В поле Webhook URL укажите URL вида {домен или ip билинга}/mancgi/ppexpandedresult. IP-адрес должен быть публичным.
4. В списке событий для уведомления выберите:
  - payment.capture.completed;
  - payment.capture.declined;
  - payment.capture.denied;
  - payment.capture.pending;
  - payment.capture.reversed.
5. Сохраните настройки и скопируйте значение Webhook ID — уникальный идентификатор, позволяющий PayPal автоматически отправлять данные другому веб-сервису. Понадобится при настройке модуля оплаты PayPal Expanded в Clouden.
Включите необходимые функции приложения:
1. Перейдите в раздел Features.
2. Включите опции:
  - Apple Pay;
  - Google Pay;
  - Expanded checkout;
  - Save payment method;
  - Subscriptions;
  - Invoicing;
  - Payment links and buttons.

Настройка на стороне Clouden

При установке модуля платформа будет обновлена до последней версии. Это происходит из-за того, что модуль устанавливается из последней версии продукта, а версия платформы не может быть ниже версии модуля. Перед установкой модуля рекомендуем создать резервную копию платформы. Подробнее см. в статье Резервное копирование

Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать :

Выбор модуля оплаты: "PayPal Expanded".
Настройка интеграции. Укажите данные для интеграции.
Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
Заполните форму, используя данные существующего клиента в платёжной системе:
1. ID приложения — уникальный идентификатор приложения. Чтобы узнать его, авторизуйтесь в личном кабинете PayPal и перейдите в раздел Dashboard → REST API apps → параметр приложения Client ID.
2. Секретный ключ приложения — ключ приложения для доступа к API PayPal. Чтобы узнать его, авторизуйтесь в личном кабинете PayPal и перейдите в раздел Dashboard → REST API apps → параметр приложения Secret.
3. Тестовый режим — опция для работы платёжного модуля в тестовом режиме. В этом режиме Clouden подключается к песочнице PayPal. Для работы с ней создайте аккаунт на сайте developer.paypal.com.
4. Способ оплаты — выберите один или несколько способов оплаты, доступных для данного платёжного модуля.
5. Рекуррентные платежи — активируйте опцию, чтобы разрешить автоматическое пополнение лицевого счёта и создание подписок. Если опция активна, укажите:
  - Страница возврата при успешном автоплатеже — страница, на которую будет перенаправлен плательщик при успешном автоплатеже. Используйте страницу Clouden https://domain.com/billmgr?func=payment.recurring.success или произвольную;
  - Страница возврата при неудачном автоплатеже — cтраница, на которую будет перенаправлен плательщик при неудачном автоплатеже. Используйте страницу Clouden https://domain.com/billmgr?func=payment.recurring.fail или произвольную.
6. Webhook ID — введите ID Webhook от PayPal, который вы сохранили при настройке со стороны Paypal.
Настройка метода оплаты. Настройте внутренние (в пределах Clouden) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.

Дополнительно

Валюты

Список поддерживаемых валют. Подробнее см. документацию PayPal.

Код	Наименование	Международное наименование	Особенность
AUD	Австралийский доллар	Australian dollar
BRL	Бразильский реал	Brazilian real	Только для платежей внутри страны
CAD	Канадский доллар	Canadian dollar
CNY	Китайский юань	Chinese renminbi	Только для платежей внутри страны
CZK	Чешская крона	Czech koruna
DKK	Датская крона	Danish krone
EUR	Евро	Euro
HKD	Гонконгский доллар	Hong Kong dollar
HUF	Венгерский форинт	Hungarian forint	Zero-digit currency — без десятичных знаков
ILS	Израильский шекель	Israeli new shekel
JPY	Японская иена	Japanese yen	Zero-digit currency — без десятичных знаков
MXN	Мексиканское песо	Mexican peso
TWD	Новый тайваньский доллар	New Taiwan dollar	Zero-digit currency — без десятичных знаков
NZD	Новозеландский доллар	New Zealand dollar
NOK	Норвежская крона	Norwegian krone
PHP	Филиппинское песо	Philippine peso
PLN	Польский злотый	Polish złoty
GBP	Фунт стерлингов	Pound sterling
SGD	Сингапурский доллар	Singapore dollar
SEK	Шведская крона	Swedish krona
CHF	Швейцарский франк	Swiss franc
THB	Таиландский бат	Thai baht
USD	Доллар США	United States dollar

По умолчанию для аккаунта не поддерживаются некоторые валюты. Чтобы включить автоматический приём платежей в неподдерживаемой валюте, активируйте опцию в личном кабинете PayPal: Профиль и настройки → Мои инструменты продаж → Настройки приёма платежей → опция Разрешить получение платежей, отправленных мне в неподдерживаемой валюте. Если эта опция неактивна, платежи в неподдерживаемой валюте нужно подтверждать вручную.

Комиссия

За каждую финансовую операцию с провайдера услуг взимается комиссия. Подробнее см. документацию Paypal.

Возврат платежей

Чтобы включить возврат платежей, перейдите в раздел Провайдер → Методы оплаты → Изменить → включите опцию Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен".

Логирование

Логи взаимодействия Clouden с PayPal Expanded Checkout записываются в файлы:

/usr/local/mgr5/var/pmpaypalexpanded.log — лог-файл настройки метода оплаты, возврата платежей, оплата сохранённым способом;
/usr/local/mgr5/var/ppexpandedpayment.log — лог-файл открытия и взаимодействия с формой оплаты;
/usr/local/mgr5/var/ppexpandedresult.log — лог-файл выполнения платежа после того, как пользователь указал данные на форме оплаты и нажал complete;
/usr/local/mgr5/var/ppexpandedrecurring.log — лог-файл открытия и взаимодействия с формой оплаты при создании сохранённого способа оплаты;
/usr/local/mgr5/var/ppexpandedrecurringresult.log — лог-файл сохранения способа оплаты после того, как клиент указал данные на форме оплаты и нажал complete;
/usr/local/mgr5/var/ppexpandedredirect.log — лог-файл перехода со страницы оплаты на страницу статуса оплаты.