GamiPress EDD Points Gateway - WordPress Plugin

Руководство по настройке GamiPress EDD Points Gateway для магазина Easy Digital Downloads

GamiPress EDD Points Gateway нужен тем сайтам WordPress, где баллы GamiPress уже являются частью мотивации пользователя, а магазин Easy Digital Downloads продаёт цифровые товары. Это руководство не пересказывает карточку продукта. Ниже разобрано, как подготовить балльную систему, включить оплату баллами в EDD, выбрать понятный курс обмена, проверить заказ и не сломать обычные платежи.

Материал рассчитан на владельца цифрового магазина, администратора WordPress или разработчика, который настраивает связку GamiPress и Easy Digital Downloads на рабочем сайте. В статье есть подготовка, установка, подробная настройка, практический сценарий, проверка результата, диагностика ошибок, FAQ и сравнение с близкими решениями.

Главная идея простая: пользователь сначала зарабатывает баллы в GamiPress, затем использует подходящий тип баллов как платежный метод при покупке цифрового товара. Но рабочая настройка зависит от деталей: какие points types уже созданы, как EDD показывает активные gateways, нужен ли полный расчет баллами или частичное списание, как магазин ведет учет заказов и как администратор проверяет, что баланс действительно изменился.

В руководстве намеренно нет инструкций по покупке лицензии, получению платной версии или обходу активации. Речь только о настройке уже имеющегося продукта, безопасном тестировании и принятии решения, подходит ли add-on вашему сценарию.

Какую задачу решает платежный gateway на баллах

В обычном магазине Easy Digital Downloads покупатель выбирает один из платежных способов: например встроенный тестовый gateway, PayPal, Stripe или другой подключенный метод. GamiPress EDD Points Gateway добавляет другой тип платежного метода - оплату через points type из GamiPress. Для пользователя это выглядит как вариант на checkout, а для администратора это настройка в той же логике, что и остальные gateways EDD.

Такой подход полезен не для каждого магазина. Он особенно уместен там, где баллы уже имеют смысл внутри продукта: образовательная платформа продает PDF, шаблоны или мини-курсы; закрытое сообщество выдает цифровые материалы за активность; авторский сайт позволяет обменивать участие, отзывы или выполненные задания на загрузки; маркетплейс цифровых ресурсов хочет дать постоянным пользователям не скидку, а полноценный альтернативный способ оплаты.

Ключевое отличие от купона в том, что gateway работает как способ оплаты, а не как промокод. Пользователь не вводит код скидки и не пытается подобрать сумму списания вручную. Он выбирает платежный метод на checkout, а система пересчитывает стоимость заказа в нужное количество баллов по заданному курсу.

Что происходит в связке GamiPress и EDD

Связка состоит из трех уровней. Первый уровень - GamiPress, где создаются points types: например credits, coins, gems или другое название, принятое на сайте. Второй уровень - Easy Digital Downloads, где существуют цифровые товары, корзина, checkout, настройки платежей и записи заказов. Третий уровень - сам add-on, который регистрирует выбранные типы баллов как платежные gateways внутри EDD.

В итоге администратор управляет не абстрактной "валютой сайта", а конкретным типом баллов. Если в GamiPress есть несколько points types, каждый из них нужно оценивать отдельно: подходит ли он для покупок, не слишком ли легко зарабатывается, нужен ли отдельный курс обмена, стоит ли показывать его в checkout всем пользователям.

Чем gateway отличается от частичной оплаты

В документации GamiPress для EDD Points Gateway отдельно вынесен вопрос различия между Points Gateway и Partial Payments. Это важная развилка. Gateway воспринимается как полноценный способ оплаты заказа баллами. Partial Payments предназначен для сценария, где баллы покрывают только часть покупки, а остаток оплачивается другим способом.

Практический вывод такой: если магазин хочет, чтобы пользователь закрывал весь заказ баллами, используйте GamiPress EDD Points Gateway. Если нужно разрешить списать часть суммы баллами и доплатить деньгами, смотрите в сторону отдельного add-on для частичных оплат. Не смешивайте эти ожидания в одном сценарии: иначе пользователи будут считать баллы "скидкой", а администратор будет проверять gateway как обычный платежный метод.

Кому подойдет GamiPress EDD Points Gateway, а кому лучше выбрать другой подход

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

Хороший сценарий начинается с понятной экономики. Например, пользователь получает credits за прохождение уроков, публикацию полезных материалов, участие в закрытом клубе или покупку других цифровых продуктов. Затем он может оплатить этими credits небольшой шаблон, файл, методичку, набор иконок, мини-курс или внутренний цифровой бонус.

Подходящие сценарии

• Обучающий сайт, где баллы мотивируют проходить уроки, а магазин EDD продает дополнительные материалы.
• Комьюнити вокруг цифровых продуктов, где активные участники получают доступ к загрузкам без отдельной денежной оплаты.
• Магазин шаблонов, пресетов, PDF или кода, где постоянным клиентам нужно дать понятный способ тратить накопленные баллы.
• Внутренняя бонусная система, где баллы не выводятся в деньги, но используются как закрытая валюта сайта.

Когда add-on может не подойти

GamiPress EDD Points Gateway не должен быть первым установленным плагином в пустой системе лояльности. Если вы еще не решили, за какие действия выдавать баллы, сколько стоит один балл и как показывать пользователю баланс, начните с базовой настройки GamiPress. Иначе checkout станет местом, где пользователь впервые узнает о баллах, но не понимает их смысла.

Также add-on может быть лишним, если вам нужен именно купон, скидка за достижение, реферальная программа или частичная оплата. Для таких задач в экосистеме GamiPress и EDD есть другие решения: discounts, points per purchase total, partial payments или отдельные loyalty plugins. Gateway удобен тогда, когда points type должен выглядеть как платежный способ.

Что проверить перед установкой

Перед установкой стоит пройти не формальный чек-лист, а цепочку зависимостей. GamiPress EDD Points Gateway работает на стыке баланса пользователя, корзины EDD и платежных настроек, поэтому ошибка в любом из этих слоев может выглядеть как "gateway не появился" или "баллы не списались".

Базовые зависимости

На сайте должны быть установлены и активны WordPress, GamiPress и Easy Digital Downloads. В GamiPress должен существовать хотя бы один points type, который вы готовы использовать для покупок. В EDD должен быть рабочий checkout, настроенная страница оформления заказа и хотя бы один тестовый цифровой товар, на котором можно проверить покупку без риска для реальных клиентов.

В EDD путь к платежным настройкам находится в админ-панели по логике Downloads -> Settings -> Payments. В этой области EDD показывает active gateways, default gateway, test mode и другие параметры платежного процесса. Если базовый checkout EDD не работает с тестовым gateway, сначала исправьте EDD, а уже потом настраивайте оплату баллами.

Балльная экономика до включения gateway

До активации оплаты баллами ответьте на три вопроса. Первый - какой points type станет платежным. Второй - какой курс обмена будет понятен пользователю. Третий - как пользователь увидит свой баланс до checkout. Если баллы выдаются слишком щедро, цифровые товары могут обесцениться. Если курс слишком сложный, покупатель будет сомневаться, почему один файл стоит именно столько points.

Для первого запуска выбирайте один points type и один небольшой тестовый товар. Не включайте сразу несколько типов баллов для всего каталога. Безопасная стратегия - начать с ограниченного сценария, проверить списание и только потом расширять доступность.

Тестовая среда и резервный план

EDD поддерживает test mode, который позволяет проверять платежный процесс без реальной транзакции. Для балльного gateway это особенно полезно: вы можете создать тестового пользователя, вручную выдать ему баллы в GamiPress, оформить тестовый заказ и посмотреть, как меняются баланс, order details и сообщение на receipt page.

Перед включением на живом сайте проверьте сценарий на копии магазина или хотя бы в EDD test mode. Откат должен быть простым: отключить gateway в платежных настройках EDD, вернуть обычный default gateway и вручную скорректировать баланс тестового пользователя, если проверка была неудачной.

Установка и первичное включение

Установка технически похожа на любой WordPress plugin add-on: файл загружается через Plugins -> Add New -> Upload Plugin, затем активируется. Но после активации главное не наличие строки в списке плагинов, а появление балльного платежного метода в платежной области EDD.

Не начинайте с оформления реального заказа. Сначала проверьте, что GamiPress видит нужный points type, EDD видит новый gateway, а пользовательская роль тестового аккаунта может проходить checkout. Если на сайте используются кеш, оптимизация JavaScript, кастомная тема checkout или checkout-блоки, тестируйте именно публичную страницу оформления заказа, а не только админку.

Порядок первичной проверки

1. Убедитесь, что GamiPress активен и в меню GamiPress создан points type с понятным slug.
2. Проверьте, что Easy Digital Downloads показывает рабочие страницы магазина, корзины и checkout.
3. Активируйте GamiPress EDD Points Gateway в разделе плагинов WordPress.
4. Откройте Downloads -> Settings -> Payments и найдите новый payment gateway, связанный с points type.
5. Включите только тот gateway, который будете тестировать первым, и сохраните настройки.
6. Создайте или выберите тестового пользователя, затем выдайте ему достаточный баланс выбранных баллов.

Какие признаки говорят, что add-on подключился

В админке EDD должен появиться платежный метод на базе points type. На checkout пользователь должен видеть вариант оплаты баллами, если gateway включен и условия заказа позволяют его использовать. После тестовой покупки в заказах EDD должна появиться запись покупки, а в GamiPress должен быть виден изменившийся баланс или соответствующая запись earnings/logs, если такой вывод включен в вашей настройке.

Если gateway не отображается в EDD, не пытайтесь сразу переустанавливать все плагины. Чаще причина проще: points type не создан, add-on не активирован, платежный метод не включен в active gateways, страница checkout кешируется, пользователь не вошел в аккаунт или тестовый товар добавлен в корзину не так, как ожидает EDD.

Настройка points gateway после установки

Этот раздел важнее самой установки. GamiPress EDD Points Gateway становится полезным только после настройки курса обмена, текста payment method и тестового сценария. В официальной логике GamiPress для points gateway ключевым параметром является conversion rate между баллами и валютой магазина. Именно он решает, сколько баллов нужно потратить за условную единицу цены товара.

Выбор points type

Если в GamiPress есть несколько типов баллов, не включайте все автоматически. Один points type может быть игровой валютой, другой - показателем репутации, третий - редкой наградой за достижения. Платежным лучше делать тот тип, который действительно предназначен для расходования. Репутационные баллы, ранги и достижения часто лучше оставить как статус, а не как платежный ресурс.

Проверьте singular/plural name и slug points type. Названия видит пользователь, а slug используется во внутренних ссылках, shortcodes и настройках. Если points type называется небрежно или слишком технически, checkout будет выглядеть недоверительно. Лучше заранее привести название к понятной форме: "Credits", "Coins", "Stars" или другое имя, принятое в интерфейсе сайта.

Курс обмена и первая математика

Курс обмена должен быть простым. Если товар стоит 10 единиц валюты, а курс 100 points за 1 единицу валюты, покупатель тратит 1000 points. Такой пример легко объяснить пользователю и легко проверить администратору. Сложные курсы вроде 37 points за 1 единицу валюты могут быть математически выгодны, но ухудшают понимание checkout.

Для первого запуска используйте курс, который не требует калькулятора. Затем проверьте три товара: дешевый, средний и дорогой. В каждом случае сумма баллов должна выглядеть ожидаемо. Если дорогой товар становится почти недостижимым, пользователи перестанут воспринимать баллы как реальную ценность. Если любой товар покупается за пару простых действий, экономика будет слишком щедрой.

Пример стартовой логики курса

• Небольшие бонусные файлы можно оценивать так, чтобы активный пользователь мог оплатить их после нескольких действий.
• Основные цифровые продукты лучше оставлять дороже, чтобы points gateway поддерживал лояльность, а не заменял всю выручку.
• Премиальные товары стоит тестировать отдельно: для них иногда лучше оставить обычные платежи или использовать частичную оплату другим add-on.

Текст способа оплаты на checkout

Пользователь должен понимать, что выбирает. Не называйте gateway технически вроде "GamiPress Points Type Gateway". Лучше использовать текст, который совпадает с языком программы лояльности: "Pay with Credits", "Use Coins" или другое понятное название. В русскоязычном интерфейсе сайта внешний текст можно перевести через средства локализации или настройки строк, если они доступны в вашей сборке, но точные UI labels в админке лучше сверять по фактическому экрану.

Плохая подпись рождает обращения в поддержку. Если покупатель не понимает, будут ли баллы списаны полностью, можно ли доплатить деньгами и почему он не видит gateway, он прервет покупку. Добавьте короткое объяснение рядом с балансом или на странице аккаунта: сколько credits доступно и где их можно использовать.

Default gateway и порядок способов оплаты

EDD позволяет выбрать default gateway. Для большинства магазинов не стоит сразу делать points gateway способом по умолчанию. Лучше сначала оставить привычный денежный gateway default, а баллы показать как дополнительный выбор. Исключение - закрытый клуб или внутренняя витрина, где все товары изначально предназначены для оплаты баллами.

Если у пользователя недостаточно баллов, он должен понимать, что делать дальше. В сценарии полного gateway лучше либо не показывать балльную оплату как единственный вариант, либо заранее объяснить, что для покупки нужен достаточный баланс. Если нужен гибкий сценарий "часть баллами, часть деньгами", это уже зона partial payments, а не обычного points gateway.

Балльная экономика для цифрового магазина

Настройка gateway не заканчивается на включении checkbox в EDD. Если баллы становятся способом оплаты, они начинают влиять на поведение покупателей, ценность цифровых товаров и поддержку магазина. Поэтому администратору нужно заранее решить, какие товары можно покупать баллами, какие действия дают points, какие ограничения нужны для дорогих продуктов и как объяснить правила без длинной юридической страницы.

Главная ошибка - считать points gateway бесплатным подарком пользователю. Внутри сайта баллы всегда имеют цену: их выдали за активность, покупку, прохождение урока, участие в сообществе или ручное действие администратора. Если курс обмена не связан с реальной ценностью этих действий, программа быстро становится либо бесполезной, либо слишком щедрой.

Связка "заработал - потратил"

Перед запуском запишите на бумаге или в документе два списка. В первом - способы заработка points: покупка, урок, отзыв, комментарий, достижение, ручная награда. Во втором - способы расходования: PDF, шаблон, пресет, мини-курс, закрытый файл, бонусный download. Затем соедините их в один пользовательский путь. Например: пользователь проходит три коротких урока, получает credits, видит баланс в аккаунте и может оплатить небольшой ресурс в EDD.

Такой путь лучше, чем абстрактная фраза "зарабатывайте баллы и покупайте товары". Пользователь должен видеть достижимую цель. Если за одно действие дают 5 credits, а самый дешевый download стоит 5000 credits, мотивация исчезнет. Если за один комментарий дают столько points, что можно купить основной продукт, магазин потеряет контроль над ценностью.

Разделение товаров по роли

Не все downloads стоит открывать для балльной оплаты на первом запуске. Удобно разделить каталог на три группы. Первая группа - низкорисковые бонусы: чек-листы, дополнительные PDF, мини-наборы, небольшие шаблоны. Вторая группа - основные товары, которые можно тестировать после успешного запуска. Третья группа - продукты, которые лучше оставить за денежной оплатой или вынести в отдельное правило: крупные bundles, лицензии, подписочные продукты, персональные услуги, товары с ограниченным количеством или высокой себестоимостью поддержки.

Если add-on в вашей конфигурации показывает points gateway для всего checkout, пользователь может добавить в корзину разные товары. Поэтому тестируйте не только один download, а реальные комбинации корзины. Если магазин использует bundles, variable pricing или скидки, заранее решите, как points gateway должен вести себя для итоговой суммы. Не обещайте правила, которые вы не проверили на фактическом checkout.

Простой стартовый принцип

Для первого запуска выбирайте товары, где результат легко проверить. Один цифровой файл, простая цена, один points type, один курс, один тестовый пользователь. После стабильной проверки можно расширять сценарий. Такой порядок не выглядит эффектно, зато он защищает от ситуации, когда пользователи массово покупают разные продукты, а администратор не понимает, почему списание points отличается от ожиданий.

Как объяснить правила пользователю

Правила не должны быть длинными. Достаточно нескольких понятных тезисов: какие points используются, где посмотреть баланс, можно ли оплатить заказ полностью, что делать при недостаточном балансе и возвращаются ли points при возврате заказа. Разместите эти правила рядом с балансом, на странице программы лояльности или в FAQ магазина.

Не прячьте курс обмена. Если пользователь видит только итог на checkout, он может воспринять списание как непрозрачное. Простая формула в человеческом виде снижает нагрузку на поддержку: "1 единица цены товара равна 100 credits" или "Цена в credits рассчитывается автоматически на checkout". Формулировку подберите под фактические возможности интерфейса, но не оставляйте пользователя гадать.

Как показать баланс и подготовить пользователя к покупке

Слабое место многих программ лояльности - пользователь узнает о баллах слишком поздно. Если покупатель видит points gateway только на checkout, он может не понять, почему система предлагает оплату чем-то, о чем раньше не говорила. Поэтому настройку gateway лучше дополнять выводом баланса в аккаунте, личном кабинете, виджете или на странице с правилами программы.

GamiPress предоставляет shortcode [gamipress_points] для вывода баланса пользователя или суммы баллов сайта. Для этого руководства полезнее сценарий текущего пользователя: показать конкретному клиенту, сколько points у него есть перед переходом к цифровым товарам.

Минимальный блок баланса

Если сайт использует страницу аккаунта или отдельную страницу программы лояльности, можно добавить понятный блок с балансом и ссылкой на каталог EDD. Пример shortcode нужно адаптировать под slug вашего points type:

[gamipress_points type="credits" current_user="yes" thumbnail="yes" label="yes" inline="no"]

После добавления проверьте страницу под тестовым пользователем. Баланс должен совпадать с тем, что видно в админке GamiPress. Если shortcode показывает не текущего пользователя, проверьте атрибут current_user и убедитесь, что пользователь вошел в аккаунт.

Что написать рядом с балансом

Рядом с балансом не нужно длинное рекламное описание. Достаточно объяснить механику: баллы можно использовать на checkout как payment method, если их хватает на стоимость заказа. Если магазин оставляет часть товаров только за обычную оплату, укажите это в правилах, а не заставляйте пользователя узнавать ограничение в момент оформления заказа.

Хороший пользовательский путь: пользователь видит баланс, понимает курс, выбирает цифровой товар, на checkout видит тот же тип баллов и после заказа получает понятную запись о покупке.

Механика оплаты: от баланса пользователя до записи заказа

Чтобы уверенно диагностировать add-on, нужно понимать путь данных. Баллы не являются самостоятельной банковской валютой. Это внутренний баланс GamiPress, который gateway использует как источник стоимости. EDD, в свою очередь, продолжает вести запись заказа, хранить состав покупки и показывать результат в order details.

Input: что должно быть на входе

На входе есть пользователь с аккаунтом, баланс выбранного points type, цифровой товар EDD и включенный payment gateway. Если пользователь не вошел в аккаунт, балльный сценарий может стать неоднозначным, потому что баланс должен быть привязан к конкретному user ID. Поэтому для магазинов с оплатой баллами логично требовать вход или автоматическую регистрацию, если это соответствует общей настройке EDD.

Product logic: где происходит пересчет

Курс обмена переводит сумму заказа в количество баллов. Если корзина стоит 10, а курс 100 points за 1, итоговая потребность - 1000 points. Важно проверять округление и понятность суммы на нескольких товарах. Если у товара есть варианты цены, скидки или налоги, тестируйте именно реальную комбинацию, а не только простую цену одного файла.

Output: что должен увидеть пользователь

На checkout пользователь должен увидеть payment method, связанный с баллами, и понимать итог. После покупки он должен получить стандартный результат EDD: подтверждение покупки, доступ к download links, запись в истории покупок, если такая область используется. С точки зрения пользователя это не "магическая операция GamiPress", а нормальный заказ цифрового товара, оплаченный баллами.

Verification: как проверяет администратор

Администратор проверяет два места. В EDD нужно открыть Downloads -> Orders и найти тестовый заказ. В GamiPress нужно проверить баланс и earnings/logs пользователя. Если EDD заказ есть, но баланс не изменился, смотрите настройки gateway и связку points type. Если баланс изменился, но заказ не завершился, смотрите статус заказа, checkout JavaScript, конфликты темы и настройки EDD.

Запуск на каталоге EDD: товары, скидки и статусы заказов

После удачного теста на одном товаре начинается более тонкая работа. Easy Digital Downloads часто используется не как витрина из пары файлов, а как полноценный каталог: разные downloads, pricing options, bundles, discount codes, customer history, receipts и разные платежные методы. GamiPress EDD Points Gateway должен вписаться в эту систему так, чтобы покупатель не сталкивался с неожиданными правилами.

Один товар, несколько товаров и итог корзины

Gateway работает с checkout, поэтому важна итоговая сумма заказа. На простом товаре расчет легко проверить: цена умножается на курс points. Но в корзине может быть несколько downloads, и пользователь будет ожидать, что система посчитает общий итог. Тестируйте корзину с двумя обычными товарами, затем с товаром другой цены, затем с недостающим балансом. Так вы заранее увидите, где пользователю нужен дополнительный текст или ограничение.

Если магазин продает пакеты или наборы, не считайте их автоматически безопасными для балльной оплаты. Bundle может иметь другую экономику поддержки, обновлений и perceived value. Иногда лучше начать с дополнительных материалов, а основные наборы открыть позже, когда статистика покажет, как пользователи зарабатывают и тратят points.

Скидки и купоны вместе с баллами

EDD умеет работать со скидками, а GamiPress имеет отдельные add-ons для скидок за достижения. Поэтому заранее решите, должны ли discount codes применяться к заказам, которые оплачиваются баллами. В некоторых программах лояльности это нормально: скидка уменьшает итог, и points списываются с уменьшенной суммы. В других программах это создает двойную выгоду, которую магазин не планировал.

Не формулируйте правило "скидки работают всегда", пока не проверите его на тестовом checkout. Создайте discount code, примените его к тестовому товару, выберите points gateway и посмотрите, совпадает ли итог с вашим ожиданием. Если результат спорный, лучше описать ограничение в правилах магазина или временно не сочетать купоны с балльной оплатой.

Статусы заказа и выдача файла

Для цифрового товара покупатель оценивает не только успешное списание points, но и доступ к файлу. EDD хранит заказы и позволяет администратору открыть order record, увидеть состав покупки и download links. Если после оплаты баллами order не получает статус, который открывает загрузку, пользователь будет считать покупку неудачной, даже если баланс изменился.

Поэтому проверка должна включать receipt page и реальную ссылку скачивания. Откройте заказ в EDD, найдите download link и убедитесь, что тестовый пользователь видит тот же результат в публичной части сайта. Если файл недоступен, сначала проверьте настройку самого download product: прикреплен ли файл, не ограничен ли доступ сторонним плагином, не сломан ли receipt template.

Ручные корректировки и поддержка

Даже при аккуратной настройке поддержка столкнется с ручными случаями: пользователь случайно купил не тот товар, заказ был отменен, баланс выглядит неправильным, администратор выдал points вручную. Опишите внутренний порядок: где смотреть order details, где проверять user points, кто имеет право корректировать баланс, как фиксировать причину ручного изменения.

Не давайте доступ к ручному изменению points всем менеджерам подряд. Баллы становятся платежным ресурсом, поэтому права на их корректировку должны быть такими же аккуратными, как права на управление заказами. Если в команде несколько администраторов, договоритесь о заметках: почему изменен баланс, к какому order ID относится корректировка, нужно ли уведомить пользователя.

Практический пример: цифровой бонус за активность

Разберем предметный сценарий. У сайта есть обучающие материалы и магазин EDD. Пользователи получают credits за прохождение уроков и комментарии к заданиям. Администратор хочет разрешить оплатить небольшой PDF-бонус только credits, чтобы активные участники могли получить материал без денежного платежа.

Цель

Нужно получить понятный путь: пользователь видит баланс credits, открывает товар EDD, добавляет его в корзину, выбирает оплату credits на checkout и после покупки получает download link. Администратор должен видеть заказ в EDD и уменьшенный баланс пользователя в GamiPress.

Подготовка

1. Создайте points type credits или используйте уже существующий тип, предназначенный для расходования.
2. Создайте тестовый цифровой товар в EDD с небольшой ценой и понятным названием.
3. Включите EDD test mode, если проверка идет на рабочем сайте или на копии с реальными настройками.
4. Выдайте тестовому пользователю баланс больше расчетной стоимости товара в credits.
5. Добавьте на страницу аккаунта shortcode баланса, чтобы пользователь видел credits до checkout.

Шаги настройки

В EDD откройте платежные настройки и включите gateway, связанный с выбранным points type. В настройках gateway задайте текст, который пользователь увидит при оформлении заказа, и курс обмена. Для первого теста используйте простой курс: например 100 credits за 1 единицу валюты магазина. Сохраните настройки, очистите кеш checkout, если он есть, и откройте сайт в отдельном браузере под тестовым пользователем.

Добавьте тестовый товар в корзину, перейдите на checkout и выберите оплату credits. Если gateway не виден, проверьте, вошел ли пользователь в аккаунт, включен ли gateway в active gateways и достаточно ли баллов. Если gateway виден, завершите тестовую покупку и перейдите на страницу подтверждения.

Проверка результата

После успешной покупки откройте EDD order details. Там должна быть запись заказа с выбранным payment method и цифровым товаром. Затем проверьте баланс тестового пользователя в GamiPress. Он должен уменьшиться на расчетное количество credits. Если на сайте выводится shortcode баланса, обновите страницу аккаунта и убедитесь, что пользователь видит новый баланс.

Мини-итог проверки: заказ есть в EDD, download link доступен, баланс GamiPress изменился, пользователь понимает, почему списана именно эта сумма. Только после такой проверки можно включать gateway для реальных пользователей.

Нюанс с несколькими товарами и скидками

После базовой проверки повторите сценарий с двумя товарами в корзине и с действующим discount code, если скидки используются в вашем магазине. EDD ведет расчет заказа с учетом своей логики корзины, а gateway должен работать с итоговой суммой. Если результат выглядит неожиданно, не запускайте gateway на весь каталог. Сначала решите, должны ли баллы применяться к товарам со скидками, bundles, variable pricing и специальным предложениям.

Проверка результата на публичной части сайта

Админская проверка важна, но пользователь судит по публичной части сайта. Поэтому после настройки нужно пройти весь путь глазами клиента: страница баланса, карточка товара, корзина, checkout, receipt page и история покупок. Нельзя считать настройку завершенной только потому, что gateway появился в админке.

Что должно быть видно покупателю

• Баланс выбранного points type до покупки или хотя бы понятное сообщение на checkout.
• Название payment method без технических внутренних слов.
• Итоговая стоимость в баллах, если интерфейс add-on и EDD выводит такую информацию в вашей версии.
• Подтверждение покупки с download link после завершения заказа.
• Обновленный баланс после списания баллов.

Что должен видеть администратор

В Downloads -> Orders должна быть запись о покупке. EDD хранит историю заказов и позволяет открыть отдельный заказ, проверить состав покупки, статус, клиента и download links. В GamiPress должна прослеживаться логика изменения баланса. Если на сайте включены blocks или shortcodes для user earnings/logs, их можно использовать как дополнительный способ показать пользователю историю начислений и списаний.

Отдельно проверьте возвраты. Если магазин возвращает покупку, администратор должен понимать, что будет с баллами: возвращаются ли они автоматически в вашей конфигурации, нужно ли делать ручную корректировку или этот процесс должен быть описан в правилах магазина. Не обещайте пользователю автоматический возврат баллов, пока не проверите это на тестовом заказе.

Настройки совместимости с темой, кешем и checkout

Платежный gateway находится в чувствительной зоне сайта. Даже если сам add-on настроен правильно, checkout может ломаться из-за кеширования, минификации JavaScript, переопределений шаблона или кастомных блоков темы. Это не означает, что GamiPress EDD Points Gateway неисправен. Это означает, что связку нужно проверять как платежный процесс, а не как обычный виджет.

Кеш и оптимизация

Checkout, cart и receipt page лучше исключить из агрессивного кеширования. Для EDD это общее правило, но в балльном сценарии оно особенно заметно: баланс пользователя, доступные gateways и итог заказа зависят от текущего аккаунта. Если кеш показывает старое состояние, пользователь может видеть неправильный баланс или не видеть доступный gateway.

Если после включения оптимизации gateway исчезает или кнопка завершения заказа не реагирует, временно отключите минификацию и объединение JavaScript для checkout. Затем включайте оптимизацию обратно по одному модулю. Такой подход быстрее, чем бессистемно переустанавливать плагины.

Тема и кастомный checkout

Некоторые темы или конструкторы переопределяют вывод checkout. Если стандартный checkout EDD показывает gateway, а кастомная страница нет, причина может быть в шаблоне, а не в add-on. Проверьте стандартную страницу checkout, временно переключите тему на безопасную тестовую или отключите кастомные блоки, если это можно сделать на staging-копии.

Безопасное улучшение без кода

Для платежного процесса лучше не добавлять случайный JavaScript или PHP snippet. Вместо этого сделайте безопасное улучшение контента: добавьте на страницу аккаунта блок баланса через официальный shortcode GamiPress и короткое объяснение правил использования credits. Это обратимо, не вмешивается в checkout и помогает пользователю понять gateway до покупки.

Частые проблемы и диагностика

Проблемы с GamiPress EDD Points Gateway обычно проявляются в одном из пяти мест: gateway не виден, баланс не хватает или не читается, заказ не завершается, баллы не списываются, пользователь не понимает результат. Ниже - практическая диагностика от симптома к проверке.

Gateway не появляется на checkout

Симптом: в настройках вроде бы все включено, но пользователь не видит оплату баллами при оформлении заказа.

Возможные причины: points type не создан или не связан с gateway, gateway не отмечен как active, пользователь не вошел в аккаунт, checkout закеширован, тема выводит кастомный платежный блок, тестируется не та страница checkout.

Что проверить: откройте Downloads -> Settings -> Payments, проверьте active gateways и default gateway. Затем войдите под тестовым пользователем с достаточным балансом и откройте checkout в режиме без кеша.

Как исправить: включите gateway, сохраните настройки, очистите кеш checkout, временно отключите оптимизацию JavaScript и проверьте стандартный checkout EDD. Если после этого gateway появился, возвращайте оптимизацию по одному параметру.

Пользователь видит gateway, но не может оплатить

Симптом: payment method отображается, но покупка не завершается или появляется сообщение о невозможности оплаты.

Возможные причины: недостаточно баллов, неверный курс обмена, цена товара с учетом скидок стала другой, пользователь не авторизован, EDD checkout требует поля, которые не заполнены.

Что проверить: сравните стоимость заказа и баланс пользователя. Посчитайте требуемые points вручную по курсу. Проверьте обязательные поля checkout, особенно если недавно менялись настройки регистрации или адреса.

Как исправить: выдайте тестовому пользователю достаточный баланс, упростите курс, отключите спорные скидки для проверки и повторите заказ. Если проблема исчезла, возвращайте условия по одному.

Заказ создан, но баланс не изменился

Симптом: в EDD появился order, но в GamiPress у пользователя остался прежний баланс.

Возможные причины: заказ не получил статус, который add-on считает завершенным, выбран не тот points type, тест проверяется под другим пользователем, checkout был прерван до финальной обработки.

Что проверить: откройте order details в EDD и запись пользователя в GamiPress. Убедитесь, что user ID совпадает, а points type тот же, что включен в gateway.

Как исправить: повторите тест с новым заказом, одним товаром и простым курсом. Если ошибка повторяется, отключите сторонние checkout add-ons и проверьте conflict test на копии сайта.

Баллы списались, но пользователь не получил доступ к загрузке

Симптом: баланс уменьшился, но на receipt page нет download link или заказ выглядит незавершенным.

Возможные причины: статус заказа в EDD не позволяет выдачу файлов, товар настроен неверно, download file не прикреплен, страница receipt кастомизирована, сработал конфликт с плагином доступа.

Что проверить: откройте товар EDD и order details. EDD позволяет проверять download links внутри order record. Если ссылки нет даже в заказе, проблема может быть в настройке товара, а не в балльном gateway.

Как исправить: прикрепите файл к download product, проверьте покупку через встроенный test gateway EDD, затем повторите покупку через points gateway. Если test gateway тоже не выдает файл, сначала чините товар.

Покупатели путают gateway с частичной оплатой

Симптом: пользователи ожидают списать часть баллов и доплатить деньгами, но gateway требует достаточный баланс для оплаты заказа.

Возможные причины: в интерфейсе нет объяснения, название gateway звучит как скидка, правила программы лояльности описаны слишком общо.

Что проверить: прочитайте checkout глазами нового пользователя. Понятно ли, что это именно payment method? Есть ли ссылка на правила credits? Видит ли пользователь свой баланс до заказа?

Как исправить: переименуйте payment method, добавьте короткое описание балльной оплаты и, если нужен гибридный сценарий, рассмотрите отдельный add-on для partial payments вместо попытки заставить gateway работать как скидку.

Как оценить, готов ли магазин к запуску

Запуск стоит делать только после серии тестов. Не ограничивайтесь одним успешным заказом, потому что реальный checkout редко состоит из идеального случая. Проверьте разные балансы, несколько товаров, недостаточный баланс, скидку, возврат и обычный денежный gateway. Чем лучше вы понимаете границы сценария, тем меньше обращений в поддержку после включения.

Минимальный набор тестов

• Пользователь с достаточным балансом покупает один простой цифровой товар.
• Пользователь с недостаточным балансом пытается выбрать балльный gateway и получает понятное поведение.
• Покупка через обычный gateway продолжает работать после включения GamiPress EDD Points Gateway.
• Администратор видит заказ в EDD и изменение баланса в GamiPress.
• Страница баланса или аккаунта показывает актуальное количество points после покупки.
• Возврат или отмена заказа протестированы по правилам вашего магазина.

Когда включать для всех пользователей

Включайте gateway для живого каталога, когда повторяемо проходит полный путь: баланс до покупки, выбор payment method, заказ, выдача файла, изменение баланса, проверка в админке. Если хотя бы один шаг неясен, ограничьте запуск одним типом товара или одной группой пользователей. Для магазина цифровых продуктов постепенный запуск безопаснее, чем мгновенное включение на весь каталог.

FAQ по настройке и использованию

Можно ли использовать GamiPress EDD Points Gateway без Easy Digital Downloads?

Нет. Сам смысл add-on в том, чтобы добавить points type GamiPress как payment gateway именно в Easy Digital Downloads. Если магазин построен на WooCommerce, нужен другой gateway из экосистемы GamiPress.

Нужен ли пользователю аккаунт для оплаты баллами?

Практически да, потому что баланс points type привязан к пользователю. Если EDD разрешает гостевую покупку, денежные gateways могут работать, но балльная оплата должна проверять конкретный баланс. Поэтому для такого сценария лучше требовать вход или аккуратно настроенную регистрацию.

Почему gateway не стоит сразу делать default payment method?

Потому что не каждый покупатель имеет достаточный баланс. Для публичного магазина безопаснее оставить обычный денежный gateway default, а баллы показать как дополнительный вариант. Default points gateway уместен в закрытом клубе или внутреннем магазине, где все покупки задуманы как балльные.

Можно ли оплатить часть заказа баллами, а часть деньгами?

Для этого сценария в экосистеме GamiPress есть отдельная логика partial payments. Points Gateway следует воспринимать как способ полной оплаты заказа выбранным points type. Если в правилах магазина нужна смешанная оплата, не обещайте ее пользователям без отдельной проверки подходящего add-on.

Как проверить, что баллы действительно списались?

После тестовой покупки откройте order details в EDD и профиль пользователя в GamiPress. Сравните исходный баланс, расчет по курсу обмена и новый баланс. Дополнительно проверьте публичный shortcode баланса под тем же пользователем.

Повлияет ли gateway на SEO или скорость сайта?

Сам gateway относится к checkout, а не к индексируемому контенту. SEO-эффект обычно косвенный: пользователю проще пользоваться программой лояльности. По скорости важно исключить cart, checkout и receipt page из агрессивного кеширования и не ломать платежные скрипты минификацией.

Что делать, если после обновления EDD или GamiPress checkout стал вести себя иначе?

Сначала повторите тест в минимальном сценарии: один товар, один points type, простой курс, test mode, стандартная страница checkout. Затем проверьте changelog базовых плагинов, отключите оптимизацию checkout и посмотрите, повторяется ли проблема без сторонних checkout add-ons.

Когда GamiPress EDD Points Gateway будет удачным выбором

GamiPress EDD Points Gateway стоит использовать, если у сайта уже есть понятная балльная экономика GamiPress и магазин Easy Digital Downloads должен принимать эти баллы как полноценный способ оплаты. Лучший результат получается там, где пользователь заранее видит баланс, понимает курс, покупает цифровой товар и получает обычное подтверждение EDD без ощущения, что checkout стал экспериментом.

Перед запуском проверьте points type, курс обмена, active gateways, test mode, order details, вывод баланса и поведение при недостатке points. Если все тесты проходят, можно скачать установочный файл и перейти к аккуратной настройке на своем сайте.

Если же вам нужна частичная оплата, скидка за достижение, начисление баллов за сумму покупки или независимая loyalty-программа, не заставляйте gateway решать чужую задачу. Выберите более точный add-on и оставьте points gateway для сценария, где внутренние баллы действительно становятся отдельным payment method для цифровых заказов.