Для использования модуля оплаты PayPal Checkout выполните настройки на стороне платежной системы и подключите модуль в BILLmanager. Главное отличие от модуля "PayPal" — возможность совершать возврат платежей.
| Поддержка способов оплаты | ||||
|---|---|---|---|---|
| Банковские карты | Наличные | Электронные кошельки | Мобильные платежи | Интернет-банкинг |
 |  | | | |
| American Express, Discover, Mastercard, Visa. | PayPal Wallet. | |||
| Поддерживаемые возможности | ||||
| Поддержка ФЗ-54 | Возврат платежей | Рекуррентные платежи | Подписки | |
| | | | |
Настройка на стороне платежной системы
Для интеграции с BILLmanager создайте новое приложение на стороне PayPal. Для этого авторизуйтесь в личном кабинете PayPal, перейдите в раздел Dashboard→ REST API apps и нажмите Create App. Для настройки интеграции на стороне биллинговой платформы нужны значения из полей Client_ID и Secret.
Настройка на стороне BILLmanager
Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать:
- Выбор модуля оплаты: "PayPal Checkout".
- Настройка интеграции. Укажите данные для интеграции.
Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
Заполните форму, используя данные существующего клиента в платёжной системе:- ID приложения — уникальный идентификатор приложения. Чтобы узнать его, авторизуйтесь в личном кабинете PayPal и перейдите в раздел Dashboard→ REST API apps → параметр приложения Client_ID;
- Секретный ключ приложения — ключ приложения для доступа к API PayPal. Чтобы узнать его, авторизуйтесь в личном кабинете PayPal и перейдите в раздел Dashboard→ REST API apps → параметр приложения Secret ;
- Тестовый режим — опция для работы платёжного модуля в тестовом режиме. В этом режиме BILLmanager подключается к песочнице PayPal. Для работы с ней создайте аккаунт на сайте developer.paypal.com;
- URL логотипа — URL логотипа провайдера в формате gif, jpg или png. Изображение будет размещено на странице оплаты услуг клиентом. Максимальный размер изображения 190 на 60 точек. Рекомендуем начинать ссылку с "https://", чтобы браузеры не помечали страницу авторизации в BILLmanager небезопасной.
- Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.
Дополнительная информация
Валюты
Список поддерживаемых валют.
По умолчанию для аккаунта не поддерживаются некоторые валюты. Для включения автоматического приёма платежей в неподдерживаемой валюте активируйте соответствующую опцию в личном кабинете PayPal: Профиль и настройки → Мои инструменты продаж → Настройки приёма платежей → опция Разрешить получение платежей, отправленных мне в неподдерживаемой валюте . Если эта опция неактивна, то платежи в неподдерживаемой валюте необходимо подтверждать вручную.
Комиссия
За каждую финансовую операцию с провайдера услуг взимается комиссия.
Возврат платежей
Для возврата платежей активируйте соответствующий флаг в настройках метода оплаты: Провайдер → Методы оплаты → Изменить → опция Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен".
Журналирование
Журналы взаимодействия биллинговой платформы с PayPal Checkout записываются в файлы:
- /usr/local/mgr5/var/pmpaypalco.log — файл журнала настройки модуля оплаты;
- /usr/local/mgr5/var/ppcopayment.log — файл журнала процесса инициации оплаты;
- /usr/local/mgr5/var/ppcoresult.log — файл журнала проверки результата платежа.
Возможные проблемы с частичным возвратом
В тестовом режиме может не работать частичный возврат платежей. При подробном логировании отображается ошибка вида:
"name":"TRANSACTION_REFUSED","message":"Request was refused.You can not do a partial refund on this transaction","information_link":"https://developer.paypal.com/docs/api/payments/#errors","debug_id":"d4ac41412c103"Для решения этой проблемы отключите опцию проверки платежей в личном кабинете PayPal:
- Авторизуйтесь в песочнице PayPal.
- Перейдите в раздел Sandbox accounts → Profile .
- На вкладке Settings отключите опцию Payment Review .