Приймання платежів через 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 використовує єдиний доступний рахунок. Якщо рахунків кілька, OpenResa використовує єдиний рахунок, призначений для сторінки оплати, назва якого закінчується на _hpp. Перевірка з'єднання показує вибраний рахунок, наприклад Підключення до Global Payments OK — обліковий запис для обробки платежів вибрано автоматично: transaction_processing_hpp.
Якщо OpenResa не може вибрати рахунок самостійно, повідомлення перевірки містить список доступних рахунків. Скопіюйте назву рахунку, який вам вказав Global Payments, у поле Назва рахунку. Збережіть зміни. Потім знову запустіть перевірку.
Випробування в тестовому середовищі
З ідентифікаторами тестового застосунку та позначеним прапорцем Тестове середовище (пісочниця) платежі є фіктивними: жодна картка не списується, а оплачені замовлення формують рахунки-фактури серії SPECIMEN, які не мають бухгалтерської сили.
Щоб здійснити тестовий платіж, оплатіть замовлення тестовою карткою Visa 4263970000005262 з терміном дії 05/39 і кодом CVV 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 пропонує вам перевірити у своєму порталі, чи повернення коштів дійсно виконано, і виконати його, якщо ні.
