VibeFox CorvusPay for PrestaShop — Допомога

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіша. Модуль відмовляється встановлюватися на старіших версіях PHP.

Валюта: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK або USD. У кошику з будь-якою іншою валютою спосіб оплати приховується на етапі оформлення замовлення. Суми передаються з 2 десятковими знаками; підсумок із більшою кількістю знаків (наприклад, у магазині з цінами в BHD з 3 десятковими знаками) відхиляється, а не округлюється.

Акаунт CorvusPay: потрібен мерчант-акаунт CorvusPay. CorvusPay видає Store ID і Secret Key для кожного магазину окремо для тестового та робочого магазину; вони відображаються в CorvusPay Merchant Center. Success URL і Cancel URL модуля потрібно внести туди (див. Налаштування).

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

1. На панелі адміністрування перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox CorvusPay Gateway у списку модулів і натисніть Configure.

3. Введіть ліцензійний ключ VibeFox у поле License key у блоці ліцензії вгорі сторінки Configure і натисніть Activate (див. розділ Ліцензійний ключ).

4. Введіть Store ID і Secret Key вашого тестового магазину CorvusPay (а для реальних платежів — і робочого магазину). Скопіюйте Success URL і Cancel URL, які відображаються на сторінці Configure, у CorvusPay Merchant Center — для тестового та для робочого магазину.

5. Увімкніть Enable/Disable і натисніть Save. Зробіть тестове замовлення, а потім вимкніть Test Mode, щоб почати приймати реальні платежі.

Під час встановлення модуль створює статус замовлення CorvusPay payment on hold. PrestaShop прив'язує новий платіжний модуль до валют, груп клієнтів і країн, активних на той момент. Це можна змінити в Payment > Preferences; країну, яку ви активуєте пізніше, потрібно позначити там для модуля.

Налаштування

Усі налаштування розміщені на сторінці модуля: Modules > Module Manager > VibeFox CorvusPay Gateway > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка показує Тестовий режим увімкнено. Платежі йдуть у тестове середовище CorvusPay — реальні кошти не списуються. поки тестовий режим увімкнено, попереджає, коли платіжний шлюз увімкнено, але Store ID або Secret Key поточного режиму порожні (тоді спосіб оплати приховано на етапі оформлення замовлення, доки їх не заповнять), а також коли валюта за замовчуванням вашого магазину не підтримується CorvusPay.

CorvusPay

Enable/Disable: Enable CorvusPay Gateway вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яку бачать покупці на етапі оформлення замовлення. Вона також зберігається в замовленні як назва способу оплати. За замовчуванням: Credit/Debit Card (CorvusPay).

Description: текст, що відображається під способом оплати на етапі оформлення замовлення. За замовчуванням: Pay securely with your credit or debit card via CorvusPay. У тестовому режимі додається (Тестовий режим — реальний платіж не списується.).

Облікові дані магазину

Store ID і Secret Key видає CorvusPay для кожного магазину (тестового та робочого окремо), вони відображаються в CorvusPay Merchant Center.

Test Mode: використовує тестове середовище CorvusPay (wallet.test.corvuspay.com) і тестові Store ID та Secret Key. За замовчуванням: увімкнено. Вимкніть, щоб приймати реальні платежі на wallet.corvuspay.com.

Test Store ID: числовий Store ID вашого тестового магазину CorvusPay.

Test Secret Key: Secret Key вашого тестового магазину CorvusPay, який використовується для підписів HMAC-SHA256.

Live Store ID: числовий Store ID вашого робочого магазину CorvusPay.

Live Secret Key: Secret Key вашого робочого магазину CorvusPay, який використовується для підписів HMAC-SHA256.

Clear saved secrets: позначте Test Secret Key або Live Secret Key і натисніть Save, щоб видалити його.

Store ID має містити лише цифри. Якщо ви введете щось інше, сторінка покаже … повинен містити лише цифри — попереднє значення збережено., а інші поля все одно зберігаються. Збережені Secret Key більше не відображаються: поле залишається порожнім і показує Збережено — залиште порожнім, щоб зберегти. Вводьте нове значення, лише якщо хочете його змінити. Платіж завжди перевіряється за Secret Key магазину, в якому його було розпочато, тож тримайте тестовий ключ заповненим, доки ще можуть надходити тестові платежі.

Success URL і Cancel URL

Скопіюйте дві адреси, які відображаються в цьому розділі, у CorvusPay Merchant Center — для тестового та для робочого магазину. CorvusPay повертає покупця на них після оплати. Копіюйте їх точно так, як їх показує сторінка; з дружніми URL вони мають вигляд прикладів нижче, можливо з кодом мови, наприклад /en/.

Success URL: має вигляд https://your-shop/module/wcp_corvuspay_gateway/success. CorvusPay підписує цей запит; замовлення створюється лише після перевірки підпису.

Cancel URL: має вигляд https://your-shop/module/wcp_corvuspay_gateway/cancel. CorvusPay її не підписує, тож вона може лише позначити як скасовану непідтверджену спробу платежу з номером замовлення CorvusPay, виданим цим магазином.

Оплата

Transaction Type: як списуються кошти з картки.

Sale (capture immediately): кошти списуються одразу (за замовчуванням).

Authorize only (capture in Merchant Center): сума лише резервується. Замовлення переходить у статус CorvusPay payment on hold; ви підтверджуєте (завершуєте) платіж у CorvusPay Merchant Center, а потім переводите замовлення в статус Payment accepted.

Payment Page Language: мова сторінки оплати CorvusPay. Site language (за замовчуванням) використовує поточну мову вашого магазину, якщо CorvusPay її підтримує, інакше англійську. Також можна обрати Hrvatski, English, Deutsch, Italiano, Srpski або Slovenščina.

Order Status After Payment: статус замовлення після успішного платежу Sale. Замовлення створюється одразу в цьому статусі.

Payment accepted (default): стандартний статус PrestaShop для оплачених замовлень.

Delivered (completed): кожне оплачене замовлення отримує статус «Доставлено».

CorvusPay payment on hold: кожне оплачене замовлення очікує вашої ручної перевірки. Платіж усе одно записується в замовлення.

Додатково

Logging: записує налагоджувальну інформацію у logs/corvuspay_p_debug.log.php у папці модуля. Файл неможливо відкрити з веб. Помилки записуються завжди, навіть коли опцію вимкнено; секрети, підписи та дані покупців — ніколи. За замовчуванням: вимкнено.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб його очистити.

Delete Data: якщо увімкнено, під час видалення модуля видаляються його налаштування та файли журналу. Замовлення, дані транзакцій CorvusPay і статус замовлення завжди зберігаються. За замовчуванням: вимкнено.

Оформлення замовлення

На етапі оплати покупець обирає спосіб оплати (за замовчуванням Credit/Debit Card (CorvusPay)) і підтверджує вибір. Наступна сторінка показує Перенаправлення на CorvusPay для оплати. Будь ласка, зачекайте... і надсилає підписану форму на сторінку оплати CorvusPay. Якщо перенаправлення не починається, покупець натискає Pay via CorvusPay; Back to checkout повертає до оформлення замовлення. Передаються сума кошика, валюта, короткий опис (номер кошика та назва магазину), а також дані адреси для рахунку та e-mail (щоб заздалегідь заповнити сторінку оплати). На цьому етапі замовлення ще немає. Той самий номер замовлення CorvusPay використовується повторно, поки не змінюються сума, валюта, режим і тип транзакції, і CorvusPay не приймає для нього другий платіж.

Після оплати CorvusPay повертає покупця на Success URL. Замовлення позначається оплаченим лише після підтвердження CorvusPay: номер замовлення CorvusPay має бути виданий цим магазином, підпис має збігатися з Secret Key магазину, в якому розпочато платіж, а сума та валюта мають збігатися з кошиком. Після цього замовлення створюється, і покупець бачить стандартну сторінку підтвердження замовлення з Ваш платіж CorvusPay отримано. Для Authorize only сторінка показує Ваш платіж CorvusPay авторизовано. Кошти буде списано, коли магазин обробить ваше замовлення., а для замовлення на утриманні — Ваш платіж отримано і його перевіряє магазин.

Якщо замовлення не можна створити в цей момент (наприклад, інший запит підтверджує той самий кошик), покупець бачить Ваш платіж підтверджується з кнопкою Check again, яка веде до підтвердження замовлення, щойно замовлення з'являється. Якщо запит на Success URL не вдалося перевірити, покупець бачить Платіж не підтверджено і Не вдалося підтвердити цей платіж CorvusPay. Якщо з вашої картки списано кошти, зверніться до магазину — не платіть повторно. Нічого не змінюється. Success URL працює, навіть коли магазин перебуває в режимі обслуговування.

Якщо покупець скасовує оплату на сторінці CorvusPay, він повертається до оформлення замовлення з незмінним кошиком і Оплату CorvusPay скасовано, замовлення не оплачено. Ваш кошик збережено — ви можете спробувати ще раз або обрати інший спосіб оплати.

Якщо оплату не вдається розпочати, покупець залишається на етапі оформлення замовлення з коротким повідомленням: CorvusPay не налаштовано. Оберіть інший спосіб оплати., CorvusPay не приймає платежі в … або Цю суму замовлення не можна сплатити через CorvusPay (вона має бути більшою за нуль і містити не більше 2 десяткових знаків). Оберіть інший спосіб оплати.

Замовлення підтверджується лише тоді, коли CorvusPay повертає покупця на Success URL; сповіщень між серверами немає. Якщо покупець закриває браузер одразу після оплати, замовлення не створюється. Модуль не підтримує повернення коштів, списання (capture) та анулювання з PrestaShop (серверний API CorvusPay вимагає клієнтський сертифікат), а також збережені картки, підписки, розстрочку та форму картки на сайті.

Замовлення

Статуси замовлення

Замовлення ще немає: покупця було відправлено в CorvusPay, і він не повернувся з підтвердженим платежем. Існує лише кошик. Якщо покупець заплатив, але не повернувся, перевірте платіж у CorvusPay Merchant Center і створіть замовлення вручну.

Payment accepted, Delivered або CorvusPay payment on hold: платіж Sale підтверджено. Статус відповідає Order Status After Payment. Платіж записується з ID транзакції CorvusPay або, якщо CorvusPay його не надсилає, з номером замовлення CorvusPay, за яким платіж можна знайти в Merchant Center. Приватна примітка до замовлення показує номер замовлення CorvusPay, код авторизації та тип картки.

CorvusPay payment on hold, authorized: обрано Authorize only. Підтвердіть платіж у CorvusPay Merchant Center, а потім переведіть замовлення в статус Payment accepted.

CorvusPay payment on hold, amount/currency mismatch: сплачена сума або валюта не збігаються з кошиком, наприклад тому, що кошик змінили в іншій вкладці. Платіж записується з фактично сплаченою сумою, якщо вона в валюті замовлення. Не відправляйте товар до перевірки платежу в CorvusPay Merchant Center.

CorvusPay payment on hold, payment after cancel: надійшов успішний платіж за спробою, яку покупець скасував. Виконайте замовлення або поверніть платіж у CorvusPay Merchant Center.

Якщо для кошика, для якого вже є замовлення, надходить інший успішний платіж, замовлення не змінюється. Примітка просить вас перевірити CorvusPay Merchant Center і за потреби повернути дубльований платіж.

Блок платежу CorvusPay

На сторінці замовлення відображається блок CorvusPay payment з номером замовлення CorvusPay, статусом спроби платежу, типом транзакції (Sale або Authorize only), сумою (і отриманою сумою, якщо CorvusPay її повідомив), кодом авторизації, транзакцією та типом картки. Тестові платежі позначаються як Test.

Повернення коштів: повернення, списання (capture) та анулювання з PrestaShop не підтримуються. Виконуйте їх у CorvusPay Merchant Center і вручну фіксуйте результат у PrestaShop.

Ліцензійний ключ

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox CorvusPay Gateway — це перший блок на сторінці Modules > Module Manager > VibeFox CorvusPay Gateway > Configure, над налаштуваннями. Вставте ключ у поле License key і натисніть Activate. Після цього блок показує ключ замаскованим, статус (наприклад, дату, до якої ліцензія дійсна, і ваш домен), а також кнопки Check now, щоб знову перевірити статус, Change key, щоб ввести інший ключ, і Remove key, щоб вилучити ключ із цього магазину. Нижче розташовані рядок Product: presta-payment-corvuspay і посилання Керування ліцензіями та доменами у вашому акаунті, яке відкриває ваш акаунт vibefox.net. Змінювати ключ можуть лише співробітники з правом Configure для модуля. Тексти блоку відповідають мові бек-офісу (включено англійську та російську).

Якщо ключ не прийнято, блок повідомляє причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on з датою. Після зміни адреси магазину або після звільнення слота домену у вашому акаунті натисніть Check now. Якщо сервер ліцензій недоступний, модуль продовжує працювати за останнім відомим статусом.

Один ключ працює на одному домені: домені основного магазину, також у конфігурації з кількома магазинами. Видалення ключа з магазину не звільняє слот домену. Звільніть слот у своєму акаунті vibefox.net.

Без активного ключа CorvusPay не показується покупцям на етапі оформлення замовлення. Якщо платіж усе ж розпочато, покупець бачить Цей спосіб оплати недоступний. Оберіть інший. Вітрина PrestaShop не знає, що ви ввійшли в бек-офіс, тож спосіб оплати приховується і для вас: ви можете налаштувати модуль до купівлі ключа, але не можете перевірити його на етапі оформлення замовлення. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються: платежі, які вже почалися, як і раніше підтверджуються, коли покупець повертається з CorvusPay.

Коли ліцензія завершується, модуль продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється під час роботи в бек-офісі: раз на добу протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Видалення або скидання модуля завжди вилучає ліцензійний ключ і статус ліцензії.

Усунення несправностей

CorvusPay не з'являється на етапі оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, Store ID і Secret Key поточного режиму заповнені (Test Store ID і Test Secret Key у тестовому режимі, Live Store ID і Live Secret Key у робочому режимі) і валюта кошика підтримується CorvusPay. У Payment > Preferences перевірте, що модуль дозволено для валюти кошика, країни клієнта та групи клієнта.

Платіж пройшов, але замовлення не створено: ймовірно, Success URL не внесено в CorvusPay Merchant Center або Secret Key у PrestaShop не відповідає магазину. Шукайте INVALID signature у полі Log на сторінці модуля (помилки записуються завжди). Замовлення також не створюється, якщо покупець закрив браузер до повернення; тоді перевірте платіж у Merchant Center і створіть замовлення вручну.

Покупець бачить Платіж не підтверджено: запит на Success URL було відхилено: бракувало обов'язкових полів, номер замовлення CorvusPay видано не цим магазином, Secret Key цього магазину порожній або підпис не збігся. Нічого не змінюється. Причину показує журнал.

Покупець довго бачить Ваш платіж підтверджується: замовлення не вдалося створити, наприклад тому що модуль було вимкнено або кошик більше не дійсний. Причину показує журнал; перевірте платіж у Merchant Center.

Покупець бачить Цю суму замовлення не можна сплатити через CorvusPay: сума дорівнює нулю або містить більше 2 десяткових знаків.

Покупець бачить CorvusPay не налаштовано або CorvusPay не приймає платежі в …: бракує Store ID або Secret Key поточного режиму, або валюта кошика не підтримується.

Замовлення має статус CorvusPay payment on hold: прочитайте приватні примітки до замовлення. Обрано Authorize only, сплачена сума або валюта не збіглися з кошиком, платіж надійшов після того, як покупець скасував оплату, або Order Status After Payment встановлено на утримання.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox CorvusPay Gateway і виберіть Uninstall. Ліцензійний ключ і статус ліцензії цього модуля завжди видаляються. Якщо Delete Data увімкнено, налаштування модуля та файли журналу буде видалено. Якщо вимкнено, усі налаштування зберігаються для повторного встановлення пізніше. Дані транзакцій CorvusPay і статус замовлення CorvusPay payment on hold завжди зберігаються, тож блок CorvusPay старих замовлень повернеться після повторного встановлення. Наявні замовлення зберігають свої примітки про оплату та ID транзакцій.

CorvusPay є торговельною маркою її правовласника. Цей модуль не пов'язаний з CorvusPay і не схвалений нею.