Разработчикам/Экосистема и ресурсы
CardV Gift Cards для WooCommerce
Продавайте цифровые подарочные карты CardV в своём магазине WooCommerce. Выберите карты для продажи — плагин создаст товары, а когда покупатель оплатит заказ, коды будут куплены с вашего баланса CardV и показаны на странице заказа и в письме о заказе.
Установить с WordPress.org ↗Получить API-ключи ↗
#Возможности
- Импорт из каталога. Просматривайте каталог CardV прямо в админке WordPress и добавляйте карты в магазин одним кликом.
- Фиксированные и произвольные суммы. Карты с фиксированным номиналом становятся одним товаром с выбором суммы. Для карт с произвольной суммой появляется поле ввода суммы с предпросмотром цены.
- Цены, которые защищают вашу маржу. Задайте наценку для всего магазина или для отдельной карты. Цена никогда не опускается ниже минимальной маржи, поэтому рост себестоимости не заставит вас продавать в убыток.
- Синхронизация по расписанию. Каталог, себестоимость и наличие синхронизируются по выбранному вами расписанию (по умолчанию каждые 6 часов).
- Автоматическая выдача по вашим правилам. После оплаты коды выдаются автоматически или ждут вашей проверки — в зависимости от способа оплаты, суммы заказа, числа заказов на покупателя и на IP, лимита для первого заказа и проверки страны.
- Коды под защитой. Коды хранятся в зашифрованном виде и показываются только купившему их покупателю. Письма администратору никогда не содержат кодов.
- Sandbox. Проверьте весь процесс с ключами Sandbox без реальных денег.
#Требования
| WordPress | 6.5 или новее |
| WooCommerce | Установлен и активирован |
| PHP | 7.4 или новее |
| Аккаунт CardV | Одобренный аккаунт мерчанта с API-ключами |
| Баланс | Предоплаченный баланс CardV; заказы оплачиваются с него |
Продавцом для ваших покупателей являетесь вы: вы устанавливаете цены, решаете, какие заказы выдаются автоматически, и сами занимаетесь поддержкой покупателей и возвратами.
#Установка
Из админки WordPress (рекомендуется). Откройте Плагины > Добавить новый (Plugins > Add New), найдите CardV Gift Cards, затем установите и активируйте плагин.
Загрузка zip-архива. Скачайте плагин с WordPress.org, затем откройте Плагины > Добавить новый > Загрузить плагин (Plugins > Add New > Upload Plugin), выберите zip-файл, установите и активируйте его.
#Настройка
- Подайте заявку на аккаунт мерчанта CardV. Аккаунты проходят проверку, прежде чем смогут делать заказы.
- В личном кабинете создайте API-ключ Sandbox и сохраните ID ключа, секрет подписи и секрет вебхука.
- Откройте CardV > Settings, выберите Sandbox, вставьте три значения и сохраните. Плагин проверит подключение. Ключи вводятся на этой странице и хранятся в зашифрованном виде; редактировать
wp-config.phpне нужно. - Скопируйте URL вебхука со страницы Settings в личный кабинет.
- Откройте CardV > Products, выберите карты для продажи и импортируйте их.
- Проверьте правила цен и выдачи, сделайте тестовый заказ, затем добавьте ключи Live и переключитесь на Live.
#Как это работает
Товары. Каждая карта CardV становится одним товаром WooCommerce. Для карт с фиксированным номиналом доступен выбор суммы; для карт с произвольной суммой — поле ввода суммы, и цена рассчитывается от суммы, которую вводит покупатель.
Цены и синхронизация. При каждой синхронизации плагин обновляет себестоимость, цену и наличие. Он никогда не перезаписывает названия, описания и изображения ваших товаров.
Выдача. Заказы, оплаченные выбранными вами способами оплаты и прошедшие ваши правила выдачи, выдаются автоматически. Все остальные ждут в CardV > Orders, пока вы их одобрите или отклоните. Если баланса CardV недостаточно, оформление заказов с подарочными картами приостанавливается, пока баланс не покроет корзину, поэтому с покупателей никогда не списываются деньги за карты, которые вы не можете выдать.
Данные ваших покупателей. Плагин передаёт в CardV только то, что нужно для покупки кодов: товары, суммы, количество, ожидаемую цену и номер заказа. Он никогда не передаёт имена, адреса электронной почты, почтовые адреса, IP-адреса или платёжные данные ваших покупателей. Подробнее — в нашей Политике конфиденциальности.
#Скриншоты

- Обзор: баланс, товары и заказы, требующие вашего внимания.

- Импорт товаров из каталога CardV.

- Выбор суммы на странице товара.

- Коды подарочных карт на странице заказа.

- Правила цен и выдачи.
#Вопросы и ответы
Нужен ли аккаунт CardV? Да. Плагин продаёт товары CardV и оплачивает их с вашего баланса CardV.
Можно ли менять названия, описания и изображения товаров? Да. Синхронизация обновляет только себестоимость, цену и наличие.
Может ли моя тема изменить вид кодов? Да. Скопируйте нужный файл из папки templates плагина в yourtheme/cardv-gift-cards/ и отредактируйте его.
Что удаляется при удалении плагина? Настройки, зашифрованные секреты, задания по расписанию и журнал действий. Ваши товары и заказы остаются в WooCommerce, а выданные коды остаются в заказах в зашифрованном виде.
#Поддержка
Плагин бесплатный и распространяется по лицензии GNU General Public License версии 2 или более поздней. Использование сервиса CardV регулируется нашими Условиями обслуживания. Если нужна помощь, напишите на [email protected], указав ваш Merchant ID и номер заказа.
Вопросы по интеграции? Напишите на [email protected], указав ваш Merchant ID и ID заказа или запроса.