VibeFox Paysera for PrestaShop — Помощь

Требования

PrestaShop: 8.0–9.x.

PHP: 8.0 или новее. Модуль не устанавливается на более старые версии PHP.

Проект Paysera: нужны идентификатор проекта и пароль проекта (sign key) вашего проекта Paysera. Способы оплаты, которые видит покупатель, — это способы, включённые в этом проекте. Для callback-уведомления в Paysera ничего настраивать не нужно: его URL передаётся с каждым запросом на оплату.

Доступный магазин: заказы создаются callback-уведомлением Paysera, поэтому ваш магазин должен быть доступен из интернета, а не за логином, базовой аутентификацией или файрволом. Callback-уведомление работает и тогда, когда магазин находится в режиме обслуживания.

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

Установка

1. В панели администратора откройте Modules > Module Manager и нажмите Upload a module. Выберите ZIP-файл модуля.

2. Когда загрузка завершится, нажмите Configure или позже найдите VibeFox Paysera Payment в списке модулей и нажмите Configure.

3. Вставьте лицензионный ключ VibeFox в поле License key в блоке лицензии вверху страницы Configure и нажмите Activate (см. Лицензионный ключ).

4. Введите Project ID и Project password из вашего аккаунта Paysera (см. раздел «Настройка»).

5. По желанию: включите Allow test payments в проекте Paysera и Test payments в модуле, чтобы опробовать процесс без списания денег. Выключите перед началом продаж.

6. Включите Enable/Disable и нажмите Save.

При установке модуль создаёт два статуса заказа: Awaiting Paysera payment и Paysera payment on hold. PrestaShop добавляет новый платёжный модуль для всех валют, стран и групп покупателей. Ограничить его можно в разделе Payment > Preferences.

Настройка

Все параметры находятся на странице модуля: Modules > Module Manager > VibeFox Paysera Payment > Configure. У каждого раздела есть своя кнопка Save, которая сохраняет всю страницу. Над полями страница показывает Paysera is hidden at checkout until the project ID and the project password are entered., пока одно из них не заполнено, и Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders., пока включены тестовые платежи или песочница.

Paysera

Enable/Disable: Enable Paysera Payment включает или выключает способ оплаты. По умолчанию: off.

Title: название способа оплаты, которое видит покупатель при оформлении заказа. Оно же сохраняется в заказе как название способа оплаты. По умолчанию: Paysera. Обязательное поле.

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely via Paysera.

Проект Paysera

Идентификатор проекта и пароль проекта находятся в вашем аккаунте Paysera в разделе Projects and activities: выберите проект и откройте General project settings.

Callback URL: адрес, по которому Paysera подтверждает каждый платёж. При ЧПУ-адресах он выглядит так: https://your-shop/module/wcp_paysera_payment/callback, возможно, с кодом языка. Он передаётся с каждым платежом автоматически, поэтому в Paysera ничего настраивать не нужно, но адрес должен быть доступен из интернета. Заказы создаются только этими подписанными callback-уведомлениями.

Project ID: числовой идентификатор вашего проекта Paysera. Принимаются только цифры: любое другое значение выводит ошибку Project ID must be a number: the numeric ID of your Paysera project. и ничего не сохраняется.

Project password: пароль проекта (sign key). Он подписывает запросы на оплату и проверяет callback-уведомления Paysera. Сохранённый пароль больше не показывается. Поле остаётся пустым и показывает Saved — leave empty to keep it. Вводите новое значение, только если хотите его изменить.

Clear saved password: отметьте Project password и нажмите Save, чтобы удалить сохранённый пароль. Пустое поле сохраняет прежнее значение.

Тестирование

Test payments: отправляет платежи в тестовом режиме, поэтому деньги не списываются. Paysera возвращает успешный тестовый платёж, не списывая средства с покупателя. Сначала включите Allow test payments в настройках проекта Paysera. Пока эта опция включена, тестовые платежи отмечают заказы как оплаченные; когда она выключена, тестовый платёж переводит заказ в состояние ожидания. По умолчанию: off. Пока опция включена, покупатели видят под способом оплаты надпись TEST MODE — no money will be charged.

Environment: куда отправляется покупатель. Для обычного проекта Paysera, в том числе для тестовых платежей, оставляйте Production. По умолчанию: Production.

Дополнительно

Debug log: записывает события платежей в logs/wc_psr_debug.log.php в папке модуля. Файл нельзя открыть из браузера. Ошибки и предупреждения записываются всегда, остальные шаги — только пока эта опция включена. Пароли и данные покупателей никогда не записываются. По умолчанию: off.

Log: показывает размер журнала и его последние записи. Нажмите Clear log, чтобы очистить его.

Delete data: если включено, при удалении модуля удаляются его настройки и журнал. Данные заказов (заказы, записи платежей Paysera, статусы заказов) всегда сохраняются. По умолчанию: off.

Оформление заказа

На этапе оплаты покупатель выбирает способ оплаты (по умолчанию Paysera) и подтверждает заказ. Модуль формирует подписанный запрос на оплату с суммой корзины в минимальных единицах валюты корзины, именем, e-mail и адресом для выставления счёта покупателя, а также с языком страницы магазина (литовский, латышский, эстонский, русский, немецкий, польский, иначе английский). Покупатель переходит в платёжное окно Paysera и выбирает там банк, карту или другой способ. На этом этапе заказа ещё не существует.

Paysera подтверждает платёж серверным callback-уведомлением. Заказ помечается оплаченным только после подтверждения Paysera подписанным callback-уведомлением; возврат покупателя в магазин никогда не создаёт заказ и не оплачивает его. Когда покупатель возвращается после callback-уведомления, показывается стандартная страница подтверждения заказа. Если банк принял платёжное поручение, но ещё не исполнил его, заказ создаётся в статусе Awaiting Paysera payment, а на странице выводится Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Для заказа на удержании страница показывает Your payment is being reviewed. We will contact you if anything else is needed.

Если покупатель возвращается до callback-уведомления, страница Payment confirmation объясняет, что заказ будет создан, как только Paysera подтвердит платёж, и предлагает Check again и Back to checkout.

Если покупатель отменяет платёж в окне Paysera, он возвращается к оформлению заказа с сообщением The Paysera payment was cancelled. You can try again or choose another payment method. Если Paysera сообщает, что платёж не был выполнен, выводится The payment was not completed. You can try again or choose another payment method. Корзина сохраняется в обоих случаях. Если у корзины уже есть заказ, новая попытка сразу ведёт на страницу подтверждения заказа, а не на второй платёж.

Если платёж не удаётся начать, покупатель остаётся на оформлении заказа с сообщением Paysera payments are temporarily unavailable. Please choose another payment method. или, при неверной сумме заказа, с This order cannot be paid via Paysera. Причина записывается в журнал.

Callback-уведомление работает, пока магазин находится в режиме обслуживания, и не блокируется ограничением по странам вашего магазина.

Модуль не поддерживает возвраты из панели администратора, выбор банка или способа оплаты на странице оформления заказа, подписки, сохранённые карты и службы доставки или курьерские службы Paysera.

Заказы

Статусы заказов

No order yet: покупатель отправлен в Paysera, а callback-уведомление ещё не пришло, или покупатель отменил платёж. Существует только корзина.

Payment accepted: Paysera подтвердила платёж с совпадающими суммой и валютой. Платёж записывается с идентификатором запроса Paysera в качестве ID транзакции, а примечание показывает запрос и способ оплаты; для тестовых платежей добавляется отметка (TEST — no money charged).

Awaiting Paysera payment: Paysera приняла платёжное поручение, но банк ещё не исполнил его. Заказ переходит в Payment accepted, когда Paysera подтверждает платёж.

Paysera payment on hold: платёж требует ручной проверки. Оплаченная сумма или валюта не совпадают с корзиной или с суммой заказа; TEST-платёж пришёл, пока Test payments было выключено (деньги не списывались); либо платёж подтверждён после того, как покупатель его отменил. Платёж не записывается. Примечание объясняет причину, а блок Paysera просит вас проверить платёж в вашем аккаунте Paysera, а затем перевести заказ в Payment accepted или отменить его и вернуть деньги через Paysera.

Cancelled: платёж, подтверждённый позже для отменённого заказа, не меняет его статус. Примечание предлагает восстановить заказ (перевести в Payment accepted) или вернуть платёж через Paysera. Более поздний TEST-платёж или несовпадение суммы для отменённого заказа тоже добавляет только примечание.

Если для уже оплаченного заказа приходит ещё один успешный платёж, заказ не меняется, а примечание просит вернуть дубликат в вашем аккаунте Paysera. Другие статусы Paysera (платёж не исполнен, требуется дополнительная информация) только добавляют примечание.

Блок платежа Paysera

На странице заказа показан блок Paysera payment с идентификатором заказа Paysera (номер корзины и попытка), идентификатором запроса Paysera, средой и отметкой TEST payment, статусом платежа, запрошенной и оплаченной суммами, способом оплаты и примечаниями модуля.

Возвраты

Возвраты из панели администратора не поддерживаются: протокол платёжного окна Paysera не имеет API для возвратов. Оформляйте возвраты в вашем аккаунте Paysera. Когда Paysera сообщает о возврате, к заказу добавляется примечание с возвращённой суммой, а статус заказа не меняется. При необходимости зафиксируйте возврат в PrestaShop вручную.

Лицензионный ключ

Модуль работает с лицензионным ключом VibeFox с сайта vibefox.net. Блок лицензии License — VibeFox Paysera Payment является первым блоком на странице Modules > Module Manager > VibeFox Paysera Payment > Configure, над настройками. Вставьте ключ в поле License key и нажмите Activate. После этого блок показывает ключ в скрытом виде, статус (например, дату окончания действия лицензии и ваш домен) и кнопки Check now, чтобы проверить статус ещё раз, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить ключ из этого магазина. Ниже них находятся строка Product: presta-payment-paysera и ссылка Manage licenses and domains in your account, которая открывает ваш аккаунт vibefox.net. Изменять ключ могут только сотрудники с правом Configure для модуля. Тексты блока соответствуют языку панели администратора (есть английский и русский).

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

Один ключ работает на одном домене: на домене основного магазина, в том числе в мультимагазинной конфигурации. Удаление ключа из магазина не освобождает слот домена. Освободите слот в своём аккаунте vibefox.net.

Без активного ключа Paysera не показывается покупателям при оформлении заказа. Если оплата всё же начата, покупатель видит сообщение This payment method is not available. Please choose another one. Витрина магазина не знает, что вы вошли в панель администратора, поэтому способ оплаты скрыт и для вас: модуль можно настроить до покупки ключа, но протестировать его при оформлении заказа нельзя. Напоминание появляется в Modules > Module Manager на вкладке Alerts. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются callback-уведомлением.

Когда срок лицензии истекает, модуль продолжает работать, но для обновлений и поддержки нужно её продлить. Статус проверяется автоматически, пока вы работаете в панели администратора: раз в день в течение первых 14 дней после ввода ключа, затем раз в неделю. Cron-задача не нужна. Удаление или сброс модуля всегда удаляет лицензионный ключ и статус лицензии.

Устранение неполадок

Paysera не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и введены Project ID и Project password. Страница настроек показывает предупреждение, пока что-либо из этого не заполнено. В Payment > Preferences проверьте, что модуль разрешён для валюты корзины, страны покупателя и группы покупателя.

Платёж прошёл, но заказ не создан: заказ создаёт callback-уведомление Paysera, а не возврат покупателя. Проверьте, что ваш магазин доступен из интернета по Callback URL, указанному в настройках (а не за логином, базовой аутентификацией или файрволом), и посмотрите поле Log на странице модуля.

Callback отвечает Invalid signature: Project password не совпадает с проектом, или callback-уведомление не от Paysera. Скопируйте пароль проекта заново. Если вы меняли проект или пароль, платежи, начатые до изменения, больше нельзя проверить.

Callback отвечает Project ID mismatch: Project ID в настройках отличается от проекта, который совершил платёж.

Callback отвечает Order not found: корзина в callback-уведомлении не имеет платежа Paysera в этом магазине, например потому что платёж был начат в другом магазине с тем же проектом.

Callback отвечает Gateway not configured, Busy или Temporary error: идентификатор или пароль проекта пуст, для той же корзины ещё выполняется другое callback-уведомление, или заказ не удалось создать (например, модуль отключён). Paysera повторяет callback-уведомление. Включите Debug log, чтобы увидеть причину.

Paysera отклоняет платёжное окно или сообщает, что проект не существует: проверьте Environment. Обычный проект Paysera работает только с Production; Sandbox требует проекта, созданного в песочнице Paysera.

Тестовый платёж не оплачивает заказ: TEST-платёж оплачивает заказ, только пока включено Test payments. Иначе заказ переводится в состояние ожидания с примечанием, что деньги не списаны. Также включите Allow test payments в проекте Paysera.

Заказ в статусе Paysera payment on hold с примечанием о несовпадении суммы или валюты: Paysera подтвердила платёж, сумма или валюта которого отличается от суммы корзины, например корзину изменили в другой вкладке после начала оплаты покупателем. Сравните платёж в вашем аккаунте Paysera и примите заказ или вручную верните платёж. Последующий правильный платёж для того же заказа отмечает его как оплаченный.

Покупатель видит Paysera payments are temporarily unavailable: посмотрите поле Log. Идентификатор или пароль проекта может быть пустым, или один из адресов магазина, переданных в Paysera, длиннее 255 символов.

Удаление

Перейдите в Modules > Module Manager, откройте меню рядом с VibeFox Paysera Payment и выберите Uninstall. Лицензионный ключ и статус лицензии этого модуля всегда удаляются. Если Delete data включено, настройки модуля и журнал удаляются. Если выключено, все настройки сохраняются для повторной установки. Записи платежей Paysera и статусы заказов Awaiting Paysera payment и Paysera payment on hold всегда сохраняются. Существующие заказы сохраняют свои примечания о платежах и идентификаторы транзакций.

Paysera — товарный знак её владельца. Модуль не связан с Paysera и не одобрен ею.