Документация BILLmanager 6

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, так как версия модуля не может быть выше версии платформы.

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

  1. Выбор модуля оплаты: "PayPal Checkout".
  2. Настройка интеграции. Укажите данные для интеграции.
    Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
    Заполните форму, используя данные существующего клиента в платёжной системе:
    1. ID приложения — уникальный идентификатор приложения. Чтобы узнать его, авторизуйтесь в личном кабинете PayPal и перейдите в раздел Dashboard→ REST API apps → параметр приложения Client_ID
    2. Секретный ключ приложения — ключ приложения для доступа к API PayPal. Чтобы узнать его, авторизуйтесь в личном кабинете PayPal и перейдите в раздел Dashboard→ REST API apps →  параметр приложения  Secret
    3. Тестовый режим — опция для работы платёжного модуля в тестовом режиме. В этом режиме BILLmanager подключается к песочнице PayPal. Для работы с ней создайте аккаунт на сайте developer.paypal.com
    4. URL логотипа — URL логотипа провайдера в формате gif, jpg или png. Изображение будет размещено на странице оплаты услуг клиентом. Максимальный размер изображения 190 на 60 точек. Рекомендуем начинать ссылку с "https://", чтобы браузеры не помечали страницу авторизации в BILLmanager небезопасной. 
  3. Настройка метода оплаты. Настройте внутренние (в пределах 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 0003,9 % + 10,00 руб.
300 000 – 750 0003,7 % + 10,00 руб.
750 000 – 1 500 0003,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: 

  1. Авторизуйтесь в песочнице PayPal.
  2. Перейдите в раздел  Sandbox accounts Profile .
  3. На вкладке  Settings отключите опцию Payment Review .