VibeFox Satispay for WooCommerce — Помощь

Требования

WordPress: 6.0 или новее.

WooCommerce: 7.0 или новее, установлен и активен. Без него плагин не активируется.

PHP: 8.0 или новее с расширением OpenSSL. Без OpenSSL плагин выводит ошибку в административной части, и способ оплаты не загружается.

Валюта: EUR. Satispay принимает платежи только в евро, поэтому способ оплаты скрывается, если валюта магазина (или, на странице Pay for order, валюта заказа) не EUR.

Аккаунт Satispay: учётная запись Satispay Business. API-ключи копировать не нужно: плагин подключается с помощью одноразового кода активации, который вы создаёте в Satispay Business Dashboard (см. раздел «Настройка»). Для тестов нужна тестовая учётная запись sandbox Satispay, которую запрашивают у Satispay for developers.

Публичный сайт: ваш сайт должен быть доступен из интернета, чтобы Satispay мог обращаться к нему при изменении платежа. Для этого в Satispay ничего настраивать не нужно.

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

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Также можно загрузить папку wcp_satispay_gateway в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > Satispay > Manage или нажмите Settings под названием плагина на странице Plugins.

4. Введите лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

5. Выберите среду: отметьте Sandbox Mode для тестов и оставьте флажок снятым для реальных платежей.

6. Вставьте код активации этой среды в поле Activation Code и сохраните. В статусе подключения появится Key ID.

7. Включите Enable/Disable и сохраните. Проверьте платёж в sandbox, затем снимите отметку Sandbox Mode и подключите боевую среду кодом активации для боевой среды.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Satispay. Раздел Satispay connection показывает состояние обеих сред, например Live: Connected с Key ID или Sandbox: Not connected, и отмечает среду, которая используется. Пока используемая среда не подключена, страница сообщает: Satispay скрыт в оформлении заказа, пока используемая среда не подключена. В списке способов оплаты WooCommerce Satispay помечается как требующий настройки, пока используемая среда не подключена, а пока включён Sandbox Mode, отображается значок тестового режима.

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

Checkout

Что покупатели видят в списке способов оплаты.

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay connection

Sandbox Mode: Use the Satispay sandbox (staging) environment. Платежи в sandbox не списываются. По умолчанию: выключено. Sandbox и боевая среда имеют отдельные ключи: подключайте каждую среду кодом активации именно этой среды. Пока используется sandbox, покупатели видят под способом оплаты надпись Режим sandbox: реальные деньги не списываются.

Activation Code: чтобы подключить среду, выбранную выше, вставьте новый 6-значный код активации и сохраните. Коды для боевой среды создаются в Satispay Business Dashboard, в разделе Online shop. Коды sandbox выдаются вместе с тестовой учётной записью Satispay. Код используется один раз и не сохраняется. Оставьте поле пустым, чтобы сохранить текущее подключение.

При сохранении с кодом плагин создаёт пару ключей RSA, отправляет открытый ключ и код в Satispay и сохраняет в базе данных WordPress Key ID и ключи этой среды. При успехе страница показывает, например, Satispay Live connected. Key ID: и далее идентификатор. Если Satispay отклоняет код, страница выводит сообщение Satispay и просит проверить, что код относится к этой среде и ещё не использован. Код с символами, отличными от букв и цифр, отклоняется до отправки чего-либо. Сохранение нового кода для среды заменяет её предыдущее подключение.

Payment notifications

В Satispay ничего настраивать не нужно. Каждый платёж имеет собственный callback URL, который Satispay вызывает при изменении платежа, а плагин перед изменением заказа заново запрашивает платёж через API Satispay. В разделе показан пример этого URL. Он выглядит так: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}. URL должен быть доступен из интернета: без режима обслуживания и без защиты паролем для /wc-api/.

Advanced

Debug log: Log API calls and payment events записывает события в WooCommerce > Status > Logs, источник wcp_satispay_gateway, без ключей и данных покупателей. Ошибки записываются всегда, даже если эта опция выключена. По умолчанию: выключено.

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted. Данные платежей, сохранённые в заказах, остаются. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Satispay) и нажимает Pay with Satispay. Плагин создаёт платёж Satispay на сумму заказа в евро с номером заказа в качестве ссылки и отправляет покупателя на страницу оплаты Satispay. На компьютере покупатель сканирует QR-код приложением Satispay. На телефоне покупатель подтверждает платёж в приложении.

После оплаты покупатель возвращается в ваш магазин. Заказ отмечается оплаченным только после подтверждения Satispay: плагин получает платёж через API Satispay, проверяет, что он создан для этого заказа, и сравнивает его статус, сумму (в центах) и валюту с заказом. Это происходит и когда Satispay вызывает callback URL, и когда покупатель возвращается, — что произойдёт раньше. Если платёж ещё не подтверждён, страница полученного заказа показывает: Satispay ещё не подтвердил вашу оплату. Заказ будет обновлён автоматически, как только придёт подтверждение.

Если покупатель уходит со страницы Satispay, не заплатив, плагин отменяет платёж в Satispay, и брошенную страницу больше нельзя оплатить. Покупатель возвращается в оформление заказа (или на страницу Pay for order) с сообщением: Ваш платёж Satispay был отменён, и ничего не списано. Вы можете попробовать снова или выбрать другой способ оплаты. То же сообщение появляется, если покупатель отклоняет платёж в приложении.

Покупатель может снова оплатить неоплаченный заказ, например со страницы Pay for order. Перед созданием нового платежа Satispay предыдущий проверяется: ожидающий платёж отменяется в Satispay, а если он уже оплачен, заказ отмечается оплаченным этим платежом и второй платёж не создаётся.

Если платёж не удалось начать, покупатель видит короткое сообщение и может выбрать другой способ оплаты: Satispay сейчас недоступен. Выберите другой способ оплаты. — если магазин не подключён или Satispay отклоняет ключи, или Не удалось создать платёж Satispay. Повторите попытку или выберите другой способ оплаты. — при других ошибках. Причина записывается в журнал.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин принимает только разовые платежи в евро. Подписок, сохранённых способов оплаты, предавторизаций и продуктовых карт он не поддерживает. Плановой проверки ожидающих платежей нет: если ни callback Satispay, ни возврат покупателя не доходят до вашего сайта, заказ остаётся в статусе Pending payment, а платёж виден в Satispay Dashboard.

Заказы и возвраты

Order statuses

Pending payment: покупатель был отправлен в Satispay и ещё не оплатил, или Satispay ещё не подтвердил платёж. В примечании к заказу указаны ID платежа Satispay, сумма и среда (Live или Sandbox).

Processing or Completed: платёж подтверждён. Заказ получает статус по стандартному правилу WooCommerce: «В обработке», а для заказов только с виртуальными загружаемыми товарами — «Выполнен». В примечании к заказу указаны платёж Satispay, сумма и способ проверки (callback, перенаправление или оформление заказа). ID транзакции — это ID платежа Satispay.

On hold: Satispay сообщил сумму или валюту, отличающиеся от суммы заказа, либо платёж был принят после отмены заказа. Примечание к заказу объясняет это, а платёж сохраняется как ID транзакции, чтобы его можно было вернуть. Проверьте платёж в Satispay Dashboard, затем завершите заказ или верните платёж.

Cancelled: последний платёж Satispay по заказу был отменён или истёк, например потому, что покупатель покинул страницу Satispay. Более старый платёж, который истекает, не отменяет заказ с более новым платежом в процессе. Заказы, которые вы создали в административной части (платёжные ссылки), не отменяются: они остаются в статусе Pending payment с примечанием, чтобы покупатель мог их оплатить.

Если для уже оплаченного заказа принят второй платёж, заказ не меняется. Примечание просит вас вернуть дублирующий платёж через Satispay Dashboard. Повторное подтверждение никогда не открывает заново отменённый или возвращённый заказ.

Refunds

Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via Satispay. Полный и частичный возврат поддерживается для заказов, оплаченных через Satispay. Возврат отправляется в ту среду, в которой был сделан платёж (боевая или sandbox), поэтому эта среда должна оставаться подключённой. Возврат считается выполненным, только когда Satispay его принимает: успешный возврат добавляется в примечания к заказу с ID возврата Satispay и причиной. Если Satispay не принимает возврат, WooCommerce показывает ошибку и возврат не регистрируется.

Возвраты, сделанные в Satispay Dashboard, не превращаются в возвраты WooCommerce. При необходимости создайте ручной возврат в WooCommerce, не используя Refund via Satispay.

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

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится в верхней части страницы WooCommerce > Settings > Payments > Satispay. Вставьте ключ в поле License key и нажмите Activate. В блоке показан статус, например дата, до которой действует лицензия, и ваш домен. Используйте Check now, чтобы повторно проверить статус, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить его с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт vibefox.net.

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

Без активного ключа Satispay не показывается покупателям при оформлении заказа. Если платёж всё же начат, покупатель видит сообщение This payment method is not available. Please choose another one. Администраторы магазина, вошедшие в систему, по-прежнему видят способ оплаты с пометкой (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются, а возвраты работают.

Когда лицензия истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется снова в фоновом режиме.

Решение проблем

Satispay не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включён, используемая среда подключена (в разделе Satispay connection для неё показано Connected) и валюта EUR.

Платёж прошёл, но заказ остаётся в статусе Pending payment: заказ обновляется, когда Satispay вызывает ваш сайт или когда покупатель возвращается. Проверьте, что ваш сайт доступен из интернета, без режима обслуживания и без защиты паролем для /wc-api/, и посмотрите WooCommerce > Status > Logs, источник wcp_satispay_gateway. Платёж виден в Satispay Dashboard.

Callback отвечает Payment status unavailable, retry later или Not configured: плагин не смог получить платёж из Satispay, или среда заказа не подключена. Заказ не изменяется. Проверьте статус подключения и журнал.

Callback отвечает Busy, retry later: заказ в этот момент обновлял другой запрос. Этот callback заказ не меняет. Заказ будет обновлён следующим callback или при возврате покупателя.

Callback отвечает Unknown payment или Missing or invalid payment_id: платёж не был создан для этого заказа, или запрос не является callback от Satispay. Заказ не изменяется.

Активация не удалась: коды активации можно использовать только один раз. Проверьте, что код относится к среде, выбранной в Sandbox Mode (код боевой среды — для боевой, код sandbox — для sandbox), создайте новый код и сохраните ещё раз. Если страница сообщает, что не удалось создать пару ключей RSA, попросите хостинг-провайдера включить расширение PHP OpenSSL.

Satispay пропал из оформления заказа после перехода из sandbox в боевой режим: sandbox и боевая среда используют разные ключи. Вставьте код активации боевой среды при снятой отметке Sandbox Mode и сохраните.

Заказ в статусе On hold, а примечание не соответствует заказу: Satispay сообщил сумму или валюту, отличающиеся от суммы заказа, например потому, что заказ был изменён после начала платежа. Проверьте платёж в Satispay Dashboard, затем завершите заказ или верните платёж.

Возврат не удаётся, потому что среда больше не подключена: платёж был сделан в боевой среде или в sandbox, а у этой среды сейчас нет ключей. Подключите её снова кодом активации или верните платёж через Satispay Dashboard.

Возврат не удаётся с сообщением Satispay did not accept the refund: Satispay вернул статус, отличный от accepted. WooCommerce не зарегистрировал возврат. Проверьте его в Satispay Dashboard.

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в аккаунте vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать с последним известным статусом.

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки платёжного шлюза, ключи Satispay обеих сред и журналы плагина удаляются, только если была включена опция Delete data on uninstall. Иначе они сохраняются для будущей повторной установки. Существующие заказы сохраняют свои платёжные примечания и ID транзакций.

Satispay является товарным знаком своего владельца. Этот плагин не связан с Satispay и не одобрен им.