Интеграция PayPal с MODX в 2021 году

Регистрация аккаунта

В целом, в регистрации нет ничего сложного, поэтому рассмотрим очень поверхностно.

1. Идём по адресу: https://www.paypal.com/ru/home выбираем тип «Корпоративный»;
2. Вводим наш почтовый адрес;
3. Вводим желаемый пароль;
4. Далее сведения о юр.лице:
   1. Имя;
   2. Фамилия;
   3. Наименование юридического лица (полное, без сокращений);
   4. Юридический адрес (у ИП нет юр.адреса, но можно указать по прописке).
   5. Ещё сведения о компании:
      1. Правовая форма;
      2. Категория товаров и услуг;
      3. Веб-сайт (необаятельно);
      4. Ещё больше сведений о компании:
         1. Дата рождения;
         2. Гражданство;
         3. Домашний адрес.

Далее, для снятия ограничений необходимо:

1. Подтвердить электронный адрес;
2. Добавить и подтвердить мою дебетовую или кредитную карту;

Ну и дождать окончания проверки данных со стороны PayPal. Далее уже опирать на их требования.

Получение ключей

1. Переходим по адресу: https://www.paypal.com/businessmanage/credentials/apiAccess;
2. Авторизовываемся;
3. Выбираем пункт «Интеграция API-интерфейсов NVP/SOAP (Classic) - Управление учетными данными API»;
4. На странице настройки выберите пункт «Запросить подпись API»;
5. После этого открывается страница с тремя параметрами, которые вам понадобятся на следующем шаге:
   1. Логин продавца;
   2. Пароль продавца;
   3. Подпись продавца;

Интеграция сайта

Для интеграции модно использовать стандартный метод оплаты PayPal в minishop2. После небольших правок он до сих пор работает и актуален.

В системных переменных указываем (полученные на предыдущем шаге данные):

• Логин продавца;
• Пароль продавца;
• Подпись продавца;
• Валюту.

Пример заполнения:

Возможные проблемы при интеграции

Тестирование оплаты в России и СНГ: To comply with international regulations, this transaction has been declined

Если вы попробуете протестировать оплату через PayPal в СНГ, то он вас просто выбросит с ошибкой: «To comply with international regulations, this transaction has been declined». Если пробовать заходить через Tor или иные способы обхода этого ограничения, то вас просто не пустит бесконечная капча.

Единственный простой способ – либо попросить протестировать весь сценарий оплаты знакомого, который реально находится в стране, где данного ограничения нет, либо заказать подобное тестирование на любой бирже фриланса. 

Проблема с SSL: Peer's Certificate issuer is not recognized

Суть проблемы в том, что SSL нет доверия.

1. Идём по пути: /core/components/minishop2/custom/payment/lib/paypal/cacert.pem
2. Меняем содержимое на вот это: https://github.com/paypal/TLS-update/blob/master/php/cacert.pem

Проблемы работы с языковыми версиями

Суть проблемы сводиться к тому, что если вы используете языковые версии, которые меняют ваш URL, добавляя к нему /en, /es, /it и т.д., то оплата PayPal ломается, т.к. неверно генерирует ссылку. 

Решение для языковых версий через разные контексты (прим. Babel):

Отсюда: https://modx.pro/help/7214

1. Ищем переменную $paymentUrl в paypal.class.php по пути: /core/components/minishop2/custom/payment
2. В /assets/components/minishop2/payment/paypal.php добавить перед переменной $success жёстко прописанные id страниц отмены: 

   if ($context == 'web') {

       $makeId = '277';

   } elseif ($context == 'ru') {

       $makeId = '278';

   }

3. Заменить на

if ($id = $modx->getOption('ms2_payment_paypal_cancel_id', null, 0)) {

         $cancel = $modx->makeUrl($makeId, $context, $params, 'full');

}

Решение для языковых версий без разных контекстов (прим. Localizator):

1. Идём по пути: /core/components/minishop2/custom/payment/paypal.class.php
2. Комментируем 21 строку кода:
   $paymentUrl = $siteUrl . substr($assetsUrl, 1) . 'payment/paypal.php';
3. Пишем жёсткий вариант:

$paymentUrl = 'https://vashsite.ru/assets/components/minishop2/payment/paypal.php';

Проблема с конвертацией валют

Данная проблема может всплыть, если у вас есть возможность смены языка и соответственно пересчёта валют по языке.

Пример сценария:

• Пользователь прыгает в любой язык «еврозоны», берёт товары по цене в валюте – евро, и условно, набирает товара на 100 евро.
• После чего, в момент перехода в корзину, он меняет контекст на рубли;
• Если по какой-то либо причине у вас на сайте поломана конвертация валют, то интеграция PayPal передаёт только значение – 100, а валюту берёт из системных настроек.
• Таким образом, в случае ошибки конвертации валют, пользователь может пропихнуть системе покупку не за 100 евро, а за 100 рублей, т.к. со стороны PayPal дополнительной проверки пары «валюта – контекст» - нет.