Download PDF
Download page PayPal Checkout (Устаревший API).
PayPal Checkout (Устаревший API)
Для использования модуля оплаты 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
Обратите внимание!
Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы 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 в статье Настройка методов оплаты.
Дополнительная информация
Валюты
Список поддерживаемых валют.
| Код | Наименование | Международное наименование | Особенность |
|---|---|---|---|
| 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 .