PayPal Checkout

Для использования модуля оплаты 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

Подключение модуля оплаты выполняется в разделе Провайдер → Методы оплаты. Мастер подключения состоит из трёх шагов:

Шаг 1. Выбор метода оплаты. В качестве метода оплаты выберите "PayPal Checkout".

Шаг 2. Настройка интеграции. Введите информацию, необходимую для интеграции с платежной системой.

Шаг 3. Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты.

Настройка интеграции

Опция Клиент в системе обработчика предлагает использовать существующий аккаунт на стороне платёжной системы или создать новый. При выборе значения "Использовать существующего" укажите на форме данные для интеграции:

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 небезопасной.

Выбор значения "Создать нового" отображает ссылку на форму регистрации в системе PayPal.

Дополнительная информация

Валюты

Список поддерживаемых валют.

Код	Наименование	Международное наименование	Особенность
AUD	Австралийский доллар	Australian dollar
BRL	Бразильский реал	Brazilian real	Только для платежей внутри страны
CAD	Канадский доллар	Canadian dollar
CZK	Чешская крона	Czech koruna
DKK	Датская крона	Danish krone
EUR	Евро	Euro
HKD	Гонконгский доллар	Hong Kong dollar
INR	Индийская рупия	Indian rupee	Только для платежей внутри страны
ILS	Израильский шекель	Israeli new shekel
MYR	Доллар малайзийский (ринггит)	Malaysian ringgit	Только для платежей внутри страны
MXN	Мексиканское песо	Mexican peso
NZD	Новозеландский доллар	New Zealand dollar
NOK	Норвежская крона	Norwegian krone
PHP	Филиппинское песо	Philippine peso
PLN	Польский злотый	Polish złoty
GBP	Фунт стерлингов	Pound sterling
RUB	Российский рубль	Russian ruble
SGD	Сингапурский доллар	Singapore dollar
SEK	Шведская крона	Swedish krona
CHF	Швейцарский франк	Swiss franc
THB	Таиландский бат	Thai baht
USD	Доллар США	United States dollar

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

Комиссия

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

Оборот, рублей в месяц	Комиссия за операцию
до 300 000	3,9 % + 10,00 руб.
300 000 – 750 000	3,7 % + 10,00 руб.
750 000 – 1 500 000	3,4 % + 10,00 руб.

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

Для возврата платежей активируйте соответствующий флаг в настройках метода оплаты: Провайдер → Методы оплаты → Изменить → опция Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен".

Журналирование

Журналы взаимодействия биллинговой системы с 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 .