Приём платежей через Global Payments
Global Payments — международный платёжный провайдер, совместимый с Desjardins (Квебек). Ваши пользователи оплачивают банковской картой на защищённой платёжной странице Global Payments. Эта страница также проводит аутентификацию 3-D Secure. Комиссии определяются вашим договором с Global Payments: OpenResa не взимает никакой комиссии с этих платежей.
Предварительные условия
Чтобы принимать реальные платежи, вашей организации нужен торговый аккаунт Global Payments, например через Desjardins в Квебеке. Ваш менеджер по работе с клиентами выдаст вам два идентификатора вашего приложения: App ID и App Key.
Чтобы опробовать шлюз до подписания договора, бесплатно создайте аккаунт на портале для разработчиков Global Payments (developer.globalpayments.com). На нём создаётся тестовое приложение с собственными App ID и App Key.
Настройка Global Payments в аккаунте выставления счетов
У каждого аккаунта выставления счетов свой платёжный шлюз. Вы можете использовать Global Payments только для части своей деятельности, а остальное оставить на другом аккаунте.
- Перейдите в Администрирование›Настройки›Выставление счетов›Платежные аккаунты, откройте нужный аккаунт выставления счетов и перейдите на вкладку Платежи.
- Включите Онлайн-платежи и выберите Global Payments в списке шлюзов.
- Вставьте свои App ID и App Key. App Key хранится в зашифрованном виде и больше никогда не отображается полностью.
- Оставьте в поле Адрес API значение
apis.globalpay.com. Выбирайтеapis.eu.globalpay.com, только если на это указал Global Payments. - Оставьте поле Название счета пустым: OpenResa сам выберет нужный аккаунт (см. ниже).
- Отметьте Тестовая среда (песочница), если вводите учётные данные тестового приложения.
- Нажмите Сохранить, затем Проверить подключение.
Регистрировать адрес для уведомлений в личном кабинете Global Payments не нужно: OpenResa сам передаёт адреса возврата при каждом платеже. Ссылка Онлайн-помощь в форме повторяет эти шаги.
Если проверка сообщает, что учётные данные отклонены, сначала проверьте флажок тестовой среды. Тестовые учётные данные работают только при отмеченном флажке, а рабочие — только при снятом.
Выбор аккаунта обработки
Приложение Global Payments может объединять несколько аккаунтов обработки платежей. Если поле Название счета пусто, OpenResa выбирает единственный доступный аккаунт или, если их несколько, единственный аккаунт для платёжной страницы, имя которого заканчивается на _hpp. Проверка подключения покажет выбранный аккаунт, например Подключение к Global Payments установлено — аккаунт обработки платежей выбран автоматически: transaction_processing_hpp.
Если OpenResa не может сделать выбор сам, в сообщении проверки перечисляются доступные аккаунты. Скопируйте в поле Название счета имя аккаунта, указанного вам Global Payments. Сохраните изменения. Затем повторите проверку.
Проверка в тестовой среде
С учётными данными тестового приложения и отмеченным флажком Тестовая среда (песочница) платежи являются фиктивными: деньги с карт не списываются, а по оплаченным заказам формируются счета серии SPECIMEN, не имеющие бухгалтерской силы.
Чтобы провести тестовый платёж, оплатите заказ тестовой картой Visa 4263970000005262 со сроком действия 05/39 и кодом CVC 599: платёж будет принят. Другие тестовые карты описаны в документации Global Payments.
Чтобы перейти в рабочий режим, замените App ID и App Key рабочими учётными данными. Снимите флажок. Сохраните изменения. Затем повторите проверку подключения.
Как проходит оплата для пользователя
При оплате пользователь выбирает Онлайн-оплата с пометкой через Global Payments. Затем он перенаправляется на платёжную страницу Global Payments на французском или английском языке, в зависимости от своего языка. Там он вводит данные карты и, если этого требует его банк, подтверждает оплату через аутентификацию 3-D Secure.
После этого он возвращается в OpenResa, который ожидает подтверждения от Global Payments: сообщение Платеж подтвержден обычно появляется примерно через десять секунд после оплаты. Затем OpenResa, как и для любого шлюза, отправляет ему подтверждение и счёт.
Действуют некоторые правила, характерные для Global Payments:
- Адрес электронной почты. Global Payments требует адрес электронной почты плательщика. Поэтому у пользователя должен быть действительный адрес длиной не более 50 символов, указанный в заказе или в его учётной записи. В противном случае онлайн-оплата будет отклонена с сообщением Для оплаты онлайн необходим действительный адрес электронной почты. Проверьте свою учётную запись.
- Валюта. Оплата производится в валюте заказа, например в канадских долларах для клуба из Квебека. Эта валюта должна быть включена в вашем аккаунте Global Payments. Иначе пользователь увидит сообщение о недоступности, а вы получите оповещение после нескольких сбоев.
- Одна попытка на страницу. После отказа по карте пользователь возвращается в OpenResa и снова запускает оплату: создаётся новая платёжная страница.
Платёжная страница Global Payments действительна 24 часа. Если пользователь её покинет, заказ останется в ожидании оплаты, и пользователь сможет оплатить его снова — через Global Payments или другим предлагаемым вами способом оплаты.
Поиск платежа
На вашем портале Global Payments у каждого платежа есть референс, объединяющий номер заказа без дефисов и номер попытки оплаты: например, BJ2026000123T15349533 соответствует заказу 2026-000123. Найдите этот номер заказа в Администрирование›Панель управления›Выставление счетов›Счета и транзакции, чтобы открыть его.
В подробностях заказа для транзакции указаны Идентификатор транзакции Global Payments, Номер авторизации и Ссылка. Параметр Журнал событий аккаунта выставления счетов показывает ответы, полученные от Global Payments, и результат повторной проверки с причиной возможного сбоя. На строке со сбоем Повторить повторно запрашивает платёж у Global Payments и регистрирует его, если он прошёл успешно.
Возврат платежа
Возврат средств запускается из Администрирование›Панель управления›Выставление счетов›Счета и транзакции: откройте заказ, нажмите Возместить, затем выберите полный или частичный возврат. При выборе плитки Global Payments OpenResa обновляет заказ и передаёт возврат в Global Payments, который возвращает средства на карту плательщика.
Полный возврат отменяет предоставленное (кредиты возвращаются, абонемент аннулируется) и переводит заказ в статус «возвращён». Частичный возврат оставляет заказ оплаченным и лишь уменьшает полученную сумму. Global Payments не позволяет вернуть больше суммы платежа.
Если Global Payments не подтверждает возврат, например из-за обрыва связи, заказ всё равно обновляется, а сообщение Возврат средств требует проверки на стороне Global Payments предлагает вам проверить на своём портале, что возврат действительно выполнен, и при необходимости выполнить его.
