OpenCart

Загальна інформація

OpenCart це безкоштовна open-source платформа для електронної комерції, що дозволить вам створити онлайн-магазини та здійснювати управління продуктами, клієнтами та замовленнями через вбудовану SEO-систему. За допомогою платіжного плагіна від Tranzzo ваш онлайн-магазин зможе приймати оплату із використанням карткових платіжних методів, а також Apple Pay та Google Pay.

Інформація про платіжний плагін:

Репозиторій з документацією до плагіну на GitHub.

Підтримувані версії WordPress: 3.x та 4.x.

Ми не рекомендуємо кастомізувати плагін, оскільки це може ускладнювати можливість його оновлення та підтримання інтеграції.

Встановлення плагіна

Встановити плагін можна у два способи: через FTP-клієнт або через адмін-панель OpenCart.

Встановлення через FTP-клієнт:

1. Завантажте останню версію з репозиторію.
2. Розпакуйте архів.
3. Завантажте файли з папкою oc_payment_tp в папку path/to/project/extension через FTP. Цей пакет не перезаписує жодних основних файлів.
4. У адмін-панелі OpenCart оберіть секцію Extensions та перейдіть до сторінки Extensions.
5. Оберіть у списку тип плагінів Payments, знайдіть Tranzzo та натисніть на зелену кнопку додавання плагіна.

Встановлення через адмін-панель OpenCart:

1. Завантажте останню версію з репозиторію
2. У адмін-панелі OpenCart оберіть секцію Extensions та перейдіть до сторінки Installer.
3. Встановіть архів (oc_payment_tp.ocmod.zip для 4 версії, та tranzzo.ocmod.zip для 3) з платіжним плагіном.
4. У адмін-панелі OpenCart оберіть секцію Extensions та перейдіть до сторінки Extensions.
5. Оберіть у списку тип плагінів Payments, знайдіть Tranzzo та натисніть на зелену кнопку для активації плагіна.

Налаштування плагіна

Налаштування плагіна включає такі кроки:

1. Зареєструйтесь у мерчант-порталі та отримайте API-ключі тестового проєкту (більше деталей у контрольному списку інтеграції).
2. У адмін-панелі OpenCart оберіть секцію Extensions та перейдіть до сторінки Extensions.
3. Оберіть у списку тип плагінів Payments, знайдіть Tranzzo та натисніть на кнопку редагування налаштувань плагіна.
4. Заповність ключі платіжного проєкту даними вашого тествого проєкту.
5. Оберіть у якому режимі буде працювати: тестовому чи приймання реальних платежів. Скористайтесь для цього опцією Тестовий режим (тестовий режим можливий лише при використанні ключів тестового проєкту).
6. Оберіть який платіжний сценарій ви хочете використовувати: одностадійний чи двостадійний за допомогу опції Холдування платежу (двостадійні платежі, якщо увімкнено).
7. Налаштуйте співвідношення між статусами замовлення в OpenCart та статусами й типами транзакцій на стороні Tranzzo (необхідно провести налаштування для одностадійного чи двостадійного сценаріїв оплати, незалежно від того, який ви будете використовувати).

інформація

Рекомендований модуль для української мови OpenCart Ukr Language.

Класичний сценарій оплати для одностадійних платежів включає:

1. Платіж знаходиться в обробці (purchase-транзакція зі статусом pending) - Processing. Замовлення створено, платіжну сторінку згенеровано, платник ввів свої платіжні дані та ініціював оплату. Платіж знаходиться в обробці або від платника очікується його підтвердження (проходження 3DS верифікації).
2. Успішне списання коштів (purchase-транзакція зі статусом success) - Complete. Замовлення успішно оплачено.
3. Помилка при списанні коштів (purchase-транзакція зі статусом failure) - Failed. Після створення замовлення у платника була невдала спроба провести оплату
4. Успішне повернення всієї суми платежу (одна refund-транзакція зі статусом success на всю суму платежу або якщо сума всіх часткових повернень дорівнює сумі платежу) - Refunded. Після успішної оплати замовлення кошти в повному обсязі були повернені.

Класичний сценарій оплати для двостадійних платежів включає:

1. Резервування коштів знаходиться в обробці (auth-транзакція зі статусом pending) - Processing. Замовлення створено, платіжну сторінку згенеровано, платник ввів свої платіжні дані та ініціював оплату. Платіж знаходиться в обробці або від платника очікується його підтвердження (проходження 3DS верифікації).
2. Успішне резервування коштів (auth-транзакція зі статусом success) - Processed. Кошти успішно зарезервовані.
3. Помилка при резервуванні коштів (auth-транзакція зі статусом failure) - Failed. Після створення замовлення була невдала спроба провести резервування коштів.
4. Успішне зарахування частини коштів резерву (capture-транзація зі статусом success на частину суми резерву) - Complete. Успішна оплата за рахунок частини суми, що була раніше зарезервована.
5. Успішне зарахування всієї суми резерву (capture-транзація зі статусом success на всю суму резерву) - Complete. Успішна оплата за рахунок всієї суми, що була раніше зарезервована.
6. Успішне скасування резерву (void-транзація зі статусом success) - Voided. Раніше створений резерв було скасовано.
7. Успішне повернення всієї суми платежу одна refund-транзакція зі статусом success на всю суму платежу або якщо сума всіх часткових повернень дорівнює сумі платежу) - Refunded. Після успішної оплати замовлення кошти в повному обсязі були повернені.

Всі платежі за вашими замовленнями відображаються у мерчант-порталі. Всі типи платежів у OpenCart відображаються за відповідним записом у списку:

Важливо

Вторинні операції (Зарахування резерву (capture), Скасування резерву (void), Повернення (refund)) можуть бути проведені тільки через мерчант-портал.