VibeFox Cardcom for WooCommerce — Помощь

Требования

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

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

PHP: 8.0 или новее.

HTTPS: ваш сайт должен быть доступен из интернета по HTTPS, чтобы Cardcom мог отправить уведомление об оплате.

Валюта: валюта заказа должна быть ILS, USD, EUR или GBP. Для любой другой валюты способ оплаты скрыт при оформлении заказа.

Учётная запись Cardcom: для рабочих платежей нужна учётная запись мерчанта Cardcom с номером терминала, именем пользователя API и паролем API. Для платежей нужны только номер терминала и имя пользователя API. Пароль API используется только для возвратов из WooCommerce. Тестовый режим работает без учётной записи Cardcom.

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

Установка

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

2. Нажмите Activate.

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

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

5. Включите Enable/Disable, оставьте Test Mode включённым и оформите тестовый заказ картой 4580 0000 0000 0000 с любым будущим сроком действия и CVV 123.

6. Для рабочих платежей снимите отметку с Test Mode и введите Terminal Number, API Username и API Password, которые вы получили от Cardcom.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Cardcom. Над полями страница показывает Test mode is on., пока включён тестовый режим. В рабочем режиме страница предупреждает, если не заполнены номер терминала или имя пользователя API (тогда Cardcom скрыт при оформлении заказа), и напоминает, что без пароля API возвраты из WooCommerce невозможны. Она также предупреждает, если валюта магазина не поддерживается. При сохранении рабочего режима без номера терминала или имени пользователя API появляется сообщение об ошибке: шлюз остаётся скрытым при оформлении заказа, пока эти поля не заполнены.

Общие

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

Title: название способа оплаты, которое видят покупатели при оформлении заказа. По умолчанию: Credit Card (Cardcom).

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

Тестовый режим

Тестовый режим использует публичный тестовый терминал Cardcom 1000 (пользователь API CardTest1994). Реальные деньги не списываются, учётная запись Cardcom не нужна. Тестовая карта: 4580 0000 0000 0000, любой будущий срок действия, CVV 123. В тестовом режиме при оформлении заказа также показывается строка с этой тестовой картой.

Test Mode: Enable test mode (terminal 1000, no real money). По умолчанию: включено. Снимите отметку, чтобы принимать реальные платежи рабочими учётными данными ниже. Возвраты всегда отправляются с учётными данными того режима, в котором был оплачен заказ.

Рабочие учётные данные

Номер терминала, имя пользователя API и пароль API вам предоставляет Cardcom вместе с учётной записью мерчанта: в панели Cardcom в разделе настроек API или через поддержку Cardcom. Эти поля используются только в рабочем режиме.

Terminal Number: номер вашего терминала Cardcom. Он должен содержать только цифры. Если введено что-то другое, появляется ошибка, и прежнее значение сохраняется.

API Username: имя пользователя API Cardcom (ApiName) для этого терминала. При сохранении пробелы удаляются.

API Password: пароль API Cardcom. Нужен только для возвратов из WooCommerce и сохраняется в точности так, как введён.

Платёжная страница

Cardcom отправляет уведомления об оплате (IndicatorUrl) на адрес, который показан в этом разделе. Он выглядит так: https://your-site/wc-api/cardcom_p_callback/. Адрес автоматически передаётся в Cardcom при каждом платеже вместе с ID заказа, поэтому в Cardcom ничего настраивать не нужно. Адрес должен быть доступен из интернета.

Operation: что делает Cardcom на платёжной странице.

Max Installments: максимальное число платежей в рассрочку, которое покупатель может выбрать на странице Cardcom, от 1 до 36. 1 означает без рассрочки. По умолчанию: 1.

Success Order Status: статус заказа после подтверждённой оплаты. Статус устанавливается сразу, без второго изменения статуса.

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

Debug log: Log API requests and notifications пишет в WooCommerce > Status > Logs, источник wcp_cardcom_payment_gateway. Ошибки записываются всегда. Учётные данные, токены карт и данные держателя карты никогда не записываются. По умолчанию: выключено.

Delete on Uninstall: Delete all plugin data when uninstalling. Если включено, удаление плагина безвозвратно удаляет настройки, данные Cardcom, сохранённые в заказах, и журналы. Сами заказы сохраняются. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Credit Card (Cardcom)) и оформляет заказ. Плагин создаёт платёжную страницу Cardcom на сумму заказа в валюте заказа и отправляет покупателя туда. Страница открывается на иврите, если язык сайта — иврит, иначе на английском. Позиции заказа передаются в Cardcom как название товара. Покупатель вводит данные карты и, если рассрочка разрешена, выбирает число платежей.

После оплаты покупатель возвращается на страницу «Заказ получен» вашего магазина. Заказ отмечается оплаченным только после подтверждения Cardcom. Cardcom обращается к адресу уведомлений, и плагин берёт из этого обращения только код платёжной страницы. Он проверяет, что этот код выдан вашим магазином именно для этого заказа, а затем запрашивает реальный результат у Cardcom с сервера на сервер. Если уведомление опаздывает, та же проверка выполняется, когда покупатель попадает на страницу «Заказ получен».

Если оплата не завершена, Cardcom возвращает покупателя к оформлению заказа (или на страницу Pay for order), где показывается сообщение The card payment was not completed. Please try again or choose a different payment method. Отказ в оплате, подтверждённый Cardcom, переводит заказ в статус Не удался. Покупатель может оплатить неоплаченный заказ снова, например со страницы Pay for order. Платёж, сделанный по более ранней платёжной странице того же заказа, по-прежнему засчитывается. Если покупатель переключился на другой способ оплаты, но заплатил на странице Cardcom, платёж записывается, а способ оплаты возвращается на Cardcom.

Если Cardcom не может открыть платёжную страницу, покупатель видит короткое сообщение, например Could not connect to Cardcom. Please try again in a moment. или сообщение о том, что не удалось открыть платёжную страницу, с кодом ошибки Cardcom, и покупатель может выбрать другой способ оплаты.

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

Плагин принимает платежи картами только на платёжной странице Cardcom. В нём нет сохранённых карт и платежей в один клик, подписок, он не списывает сохранённые токены, не имеет настроек счетов и чеков Cardcom, нет Bit, Apple Pay, Google Pay или PayPal через Cardcom, нет режима iframe и сделок с отложенным списанием. Брошенные платёжные страницы автоматически не проверяются.

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

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

Pending payment: покупатель отправлен в Cardcom и ещё не заплатил, либо Cardcom ещё не подтвердил платёж.

Processing, Completed или On Hold: оплата подтверждена. Статус соответствует настройке Success Order Status. В примечании к заказу указаны транзакция Cardcom и, когда Cardcom передаёт эти данные, последние четыре цифры карты, номер счёта и число платежей в рассрочку. Тестовые платежи отмечаются как Test mode — no real money was charged. ID транзакции заказа — это номер сделки Cardcom.

On hold after payment: Cardcom подтвердил платёж, который не соответствует заказу: например, итог заказа изменился после открытия платёжной страницы или списана другая сумма или валюта. В примечании к заказу это объясняется. Сверьте платёж в панели Cardcom с заказом, затем выполните заказ или возвратите платёж.

Failed: Cardcom отклонил платёж. В примечании к заказу показан код ответа Cardcom. Отказ по более ранней платёжной странице не влияет на новую попытку, а запоздалый отказ никогда не меняет оплаченный заказ.

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

Возвраты

Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via Credit Card (Cardcom) (на кнопке показано название способа оплаты). Поддерживаются полные и частичные возвраты, для одного заказа можно сделать несколько частичных возвратов. Возврат отправляется с учётными данными того режима, в котором был оплачен заказ: тестовые заказы возвращаются через тестовый терминал Cardcom даже после перехода в рабочий режим, а рабочие заказы всегда используют рабочие учётные данные. Для рабочих возвратов нужны API Username и API Password. Если Cardcom не принимает возврат, WooCommerce показывает ошибку, и возврат не записывается. Успешный возврат добавляется в примечания к заказу вместе с транзакцией возврата Cardcom и причиной.

Возвраты, сделанные в панели Cardcom, в магазин не передаются. При необходимости создайте ручной возврат в WooCommerce, не используя Refund via платёжного шлюза.

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

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

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

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

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

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

Cardcom не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и валюта заказа — ILS, USD, EUR или GBP. В рабочем режиме проверьте, что заполнены Terminal Number и API Username. Страница настроек показывает предупреждение, если чего-то не хватает.

Оплата прошла, но заказ остаётся в статусе Ожидание оплаты: Cardcom не может обратиться к вашему сайту, например из-за режима обслуживания, файрвола, защиты паролем или локального сайта для разработки. Адрес уведомлений должен быть доступен из интернета по HTTPS. Заказ также подтверждается, когда покупатель возвращается на страницу «Заказ получен». Включите Debug log и проверьте WooCommerce > Status > Logs, источник wcp_cardcom_payment_gateway.

Уведомление отвечает Missing or invalid lowprofilecode или Unknown lowprofilecode for this order: вызов не содержал код платёжной страницы, выданный вашим магазином для этого заказа. Заказ не изменяется.

Уведомление отвечает Gateway not configured или Indicator check failed: не заполнены учётные данные того режима, в котором создана платёжная страница, либо Cardcom не удалось связаться для проверки. Заказ не изменяется и проверяется снова, когда покупатель возвращается в магазин.

Уведомление отвечает ReturnValue mismatch или Terminal mismatch: Cardcom передал платёж другого заказа или другого терминала. Заказ не изменяется. Проверьте, что Terminal Number — это терминал вашей учётной записи.

Покупатель видит Payment error: this currency is not supported by Cardcom.: валюта заказа не ILS, USD, EUR или GBP.

Покупатель видит Card payment is temporarily unavailable. Please choose another payment method.: включён рабочий режим, но не заполнены номер терминала или имя пользователя API.

Покупатель видит ошибку при оформлении заказа: откройте примечания к заказу или включите Debug log и посмотрите журнал. Там записываются проблемы соединения и коды ошибок Cardcom.

Order is On hold after payment: прочитайте примечание к заказу. Оплаченная сумма или валюта отличались от заказа. Выполните заказ или сделайте возврат платежа.

Возврат не проходит с сообщением API username and API password are required for refunds: укажите в настройках API Password (и API Username) и повторите попытку.

Возврат не проходит с сообщением Could not connect to Cardcom: прежде чем повторять попытку, проверьте панель Cardcom: возврат мог быть выполнен или нет.

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

Для разработчиков в readme плагина описан фильтр cardcom_p_supported_currencies, который расширяет список валют (добавляйте только валюты, включённые в вашем терминале Cardcom).

Удаление

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

Cardcom — товарный знак соответствующего правообладателя. Этот плагин не связан с Cardcom и не одобрен ею.