WooCommerce Account Funds - Плагин WordPress

Руководство по WooCommerce Account Funds: настройка store credit, cashback и оплат с баланса

WooCommerce Account Funds нужен не для красивой надписи в личном кабинете, а для управляемой экономики store credit внутри магазина. В этом руководстве разберем, как использовать плагин как кошелек покупателя, систему cashback, механизм возвратов в баланс и инструмент для предоплаченных B2B или VIP-сценариев.

Материал не повторяет короткое описание продукта. Ниже будет практический маршрут: что проверить до установки, какие настройки открыть первыми, как настроить награды, top-up, частичную оплату, refunds to store credit, shortcodes и проверку результата на тестовом заказе.

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

Какую задачу решает store credit в WooCommerce

WooCommerce Account Funds добавляет в магазин баланс покупателя, который можно пополнять, начислять как награду и использовать при оплате заказа. В отличие от обычного купона, store credit привязан к аккаунту клиента и ведет себя как внутренний денежный остаток. Это удобнее, когда нужно не раздать одноразовые промокоды, а вести историю начислений и списаний по каждому покупателю.

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

Store credit не заменяет платежный шлюз и не отменяет обычные методы оплаты. Плагин добавляет отдельный способ оплаты на checkout. Если balance покрывает весь заказ, покупатель может оплатить заказ только им. Если включена частичная оплата, клиент применяет доступный остаток и доплачивает разницу другим активным шлюзом WooCommerce.

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

Кому подходит плагин и где он может быть лишним

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

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

• Программа cashback. Покупатель получает фиксированную сумму или процент store credit после оплаченного заказа, а затем использует его при следующей покупке.
• Приветственный бонус. Новый клиент создает аккаунт, получает небольшой баланс и имеет повод вернуться в магазин.
• Награда за отзывы. Покупатель оставляет отзыв о товаре, а магазин начисляет фиксированный credit с проверкой, что отзыв связан с реальной покупкой.
• Возвраты в store credit. Команда поддержки быстрее закрывает обмен или частичную компенсацию, когда клиент согласен получить баланс вместо возврата на исходный метод оплаты.
• Предоплаченные B2B-аккаунты. Компания вносит бюджет заранее, а сотрудники оформляют повторные заказы без постоянной оплаты картой.

Когда лучше выбрать другой инструмент

Если задача - раздать промокод на скидку, сделать массовые gift cards, настроить сложные BOGO-акции или запустить купоны с URL, удобнее смотреть в сторону coupon-focused расширений. Если нужна классическая points-система с курсом вроде "100 points = 1 discount unit", Account Funds может быть избыточным или потребовать осторожной терминологии. Документация Kestrel отдельно отмечает, что денежный символ можно скрывать CSS, но это только визуальная правка, а не изменение логики хранения баланса.

Также плагин не подходит для guest-first магазинов, где большинство покупателей не создает аккаунт. Store credit должен быть привязан к зарегистрированному пользователю. Если магазин намеренно оставляет checkout гостевым и не хочет мотивировать регистрацию, основная механика Account Funds будет работать хуже.

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

Перед установкой важно оценить не только версию WooCommerce и PHP, но и то, как магазин уже работает с заказами, оплатами, возвратами, ролями пользователей, кешем и checkout. Account Funds подключается к тем местам, где ошибки стоят дорого: покупатель может не увидеть баланс, cashback может не начислиться, а поддержка может сделать возврат не туда.

Техническая совместимость

Официальная страница продукта указывает актуальные требования WooCommerce и PHP, а также совместимость с современными версиями WordPress и WooCommerce. Перед установкой проверьте требования на странице продукта, потому что они могут меняться. На живом магазине дополнительно проверьте, включен ли HPOS, какие платежные шлюзы активны и используется ли блоковый checkout или классический shortcode checkout.

Плагин заявляет работу с современными WooCommerce flows, а Kestrel отдельно описывает поддержку checkout block. Но это не отменяет тестирования: разные темы и checkout-надстройки могут менять расположение блока оплаты, мини-корзину, notices и My Account endpoints.

Организационные правила

До включения cashback или refunds to store credit договоритесь внутри команды:

• Кто имеет право вручную менять баланс клиента.
• Какая формулировка будет использоваться в интерфейсе: Store Credit, Account Funds, Rewards или другой термин.
• Когда credit можно вернуть на баланс, а когда нужен возврат на исходный метод оплаты.
• Будет ли у начисленного credit срок действия.
• Как поддержка объясняет покупателю частичную оплату и остаток после заказа.

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

Кеш, личный кабинет и динамический контент

Баланс пользователя - персональные данные. Если вы выводите его через shortcode в шапке, сайдбаре или на лендинге, page cache не должен отдавать один и тот же balance разным посетителям. В документации по shortcode Kestrel прямо упоминает риск кеширования и рекомендует исключения или динамическую загрузку для страниц с персональным балансом.

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

Обычный путь установки для расширений WooCommerce - добавить продукт из аккаунта WooCommerce.com или загрузить ZIP через Plugins - Add New - Upload Plugin. В этом руководстве не разбирается покупка или лицензирование самого расширения. Цель - безопасно включить уже имеющийся плагин и убедиться, что он видит WooCommerce checkout, users и orders.

Первый маршрут в админ-панели

После активации найдите раздел Store Credit или Account Funds в админ-панели. По документации Kestrel, основные экраны находятся вокруг dashboard, transactions, cashback, milestones и settings. В старых материалах путь может называться иначе, поэтому ориентируйтесь на фактическое меню установленной версии и термин, выбранный в настройках labels.

Что должно появиться сразу

• В админ-панели появился раздел управления store credit.
• В WooCommerce - Settings - Payments доступен gateway store credit или Account Funds.
• У пользователя в профиле есть блок баланса, если плагин добавил его по документации.
• В личном кабинете клиента появился раздел или вывод баланса, если это включено в настройках display.
• В transactions или аналогичном журнале видны будущие изменения баланса.

Если этих элементов нет, не создавайте cashback-правила наугад. Сначала проверьте, активен ли WooCommerce, видит ли сайт актуальные роли, нет ли fatal errors в статусе WooCommerce, не выключен ли gateway и не конфликтует ли My Account page с кастомными endpoints.

Базовые настройки: label, top-up, gateway и display options

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

Label и терминология

В настройках labels можно заменить customer-facing название store credit. Это не косметика. Термин должен совпадать с тем, что магазин пишет в политике возвратов, письмах, FAQ и подсказках checkout. Для денежного кошелька лучше оставить прямую формулировку вроде Store Credit или Account Funds. Для программы лояльности можно выбрать Rewards, но не стоит обещать "points", если фактически баланс хранится как денежный credit.

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

Top-up из личного кабинета

Funding options позволяют разрешить ручное пополнение из My Account. Включайте top-up только если он нужен сценарию. Для refund-only системы он может быть лишним: покупателю незачем вносить деньги заранее, если магазин использует credit только для компенсаций. Для prepaid B2B, семейных аккаунтов или VIP-баланса top-up полезен, но обязательно задайте minimum и maximum.

Gateway store credit

Gateway отвечает за оплату заказов балансом. Его настраивают в WooCommerce - Settings - Payments. В description можно использовать placeholder {store_credit_balance}, чтобы покупатель видел доступную сумму. Если gateway выключен, rewards и пополнение могут продолжать начисляться, но клиент не сможет потратить balance на checkout.

Первым тестом после включения gateway должен быть заказ с маленьким балансом. Так видно, появится ли частичная оплата или gateway спрячется, если balance не покрывает весь заказ.

Cashback и milestone rewards без хаоса в правилах

WooCommerce Account Funds разделяет награды за покупки и награды за действия. Это важное отличие. Cashback привязан к order paid или product purchase. Milestone rewards привязаны к событиям вроде регистрации аккаунта или product review. Если смешать эти логики в голове, правила быстро превращаются в набор пересекающихся бонусов, которые трудно объяснить и контролировать.

Cashback за оплаченный заказ

Order paid trigger подходит для базовой программы возврата части суммы. Настройка обычно включает тип суммы, саму сумму, eligibility rules, ограничения по award count или budget и статус активности. Документация Kestrel указывает, что cashback обычно появляется при достижении заказом paid status, например Processing. Поэтому на тесте важно смотреть не только checkout, но и фактический статус заказа.

Начинайте с одной простой программы, например фиксированная небольшая сумма или умеренный процент на все оплаченные заказы. Потом добавляйте исключения: sale items, coupon orders, конкретные категории, минимальный order amount. Чем больше условий, тем больше причин, почему клиент "должен был получить cashback", но не получил его.

Product purchase trigger

Product purchase trigger полезен для точечных кампаний: новый товар, категория с высокой маржой, ограниченный promotion, clearance. Для этого режима особенно важна логика quantity. Если reward умножается на количество, покупка нескольких одинаковых товаров даст несколько начислений. Если это не нужно, проверьте настройки до запуска.

Milestone rewards за регистрацию и отзывы

Milestone rewards работают с действиями покупателя. Welcome bonus за регистрацию помогает бороться с гостевым checkout, а reward за product review стимулирует social proof. Для review rewards обязательно оцените опцию verified purchase required. Без нее пользователь может попытаться оставлять отзывы ради баланса, не покупая товар.

Лучший стартовый набор - один welcome bonus и один cashback rule. Review reward стоит добавлять позже, когда команда понимает модерацию отзывов, лимиты и бюджет программы.

Ограничения и срок действия

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

Store credit products и top-up: когда покупатель сам пополняет баланс

Store credit products позволяют продавать предоплаченный balance как обычный товар особого типа. Покупатель оплачивает продукт, а после перехода заказа в оплаченный статус сумма добавляется на его баланс. В документации Kestrel такие продукты описаны как deposit products: они выглядят в каталоге как товары, но не требуют доставки и обычно не работают как вариативные продукты.

Deposit product против top-up

Deposit product удобен, когда магазин хочет предложить фиксированные пакеты: например "пополнение на 25", "пополнение на 50", "VIP credit pack". Top-up из My Account удобен, когда клиент сам вводит сумму. Эти режимы можно сочетать, но для старта лучше выбрать один. Иначе покупатель может не понять, чем фиксированный credit product отличается от формы пополнения в личном кабинете.

Sale price и bonus credit

Документация Kestrel указывает важный нюанс: если у store credit product есть regular price и sale price, покупатель может заплатить sale price, но получить credit в размере regular price. Это работает как bonus credit без старой логики скидки за использование funds. Такой подход особенно полезен после того, как Kestrel убрала старую discounting behavior для новых установок и рекомендовала стимулировать покупку funds, а не их списание.

Риски пополнений

Предоплаченный balance - это обязательство магазина. Деньги получены сейчас, товар или услуга будут выданы позже. Для B2B и крупных пополнений нужно вести учет outstanding balances и смотреть transaction reports. Для розничного магазина задайте maximum top-up, отслеживайте необычные пополнения новых аккаунтов и не разрешайте бесконтрольные цепочки "купил credit - получил cashback - снова купил credit", если это не задумано.

Безопасное правило: если cashback распространяется на deposit products, проверьте, не создает ли это бесконечный bonus loop. Для многих магазинов deposit category лучше исключить из order-based cashback или ограничить отдельным бюджетом.

Частичная оплата на checkout и связь с другими gateway

Partial payment - одна из самых важных функций WooCommerce Account Funds. Без нее покупатель может использовать store credit только тогда, когда balance покрывает весь order total. С включенной частичной оплатой он применяет доступный остаток, а разницу оплачивает картой, PayPal, WooPayments, bank transfer или другим активным gateway.

Что происходит внутри заказа

По документации Kestrel, при частичной оплате store credit применяется к заказу, итоговая сумма уменьшается, а оставшаяся часть проходит через выбранный платежный метод. В заказе сохраняются данные о том, сколько funds было использовано, и order notes помогают восстановить историю. На практике это значит, что бухгалтерии и поддержке нужно смотреть не только payment method, но и строку store credit в totals.

Классический checkout и блоковый checkout

Kestrel описывает поддержку WooCommerce checkout block и отмечает, что расположение partial payment может отличаться от старого shortcode checkout. Поэтому нельзя проверять только один тип checkout, если магазин недавно переходил на blocks или использует кастомный checkout builder. Посмотрите, где именно покупатель видит available balance, checkbox или кнопку применения credit, как выглядит remove action и обновляется ли order total.

Купоны, минимальные суммы шлюзов и нулевые заказы

Coupons и store credit могут применяться вместе, но порядок расчета нужно проверить на вашем магазине: цена товара, coupon discount, store credit, затем external payment. Если после применения funds остается очень маленькая сумма, некоторые payment gateways могут не принять платеж из-за минимального charge. В таком случае лучше объяснить покупателю, что balance можно применить на большем заказе, или выбрать gateway, который корректно обрабатывает малые остатки.

Если balance превышает total, система должна списать только нужную часть, а остаток сохранить. Это обязательно проверяется тестовым заказом: оформите заказ меньше balance, затем откройте transactions и убедитесь, что wallet debited только на сумму покупки.

Возвраты в store credit и ручное управление балансами

Refunds to store credit полезны, когда клиент готов остаться в экосистеме магазина. Это часто работает для обменов, частичных компенсаций, loyalty goodwill и ситуаций, где исходный возврат на карту занимает время. Но такой сценарий должен быть добровольным и понятным: покупатель должен знать, что получает баланс магазина, а не банковский возврат.

Возврат заказа, оплаченного store credit

Если заказ был оплачен через store credit gateway, возврат обычно логично идет обратно в wallet, потому что внешнего платежного шлюза для этой части нет. Проверьте order notes и transaction history: в них должна быть запись, по которой понятно, какая сумма вернулась и к какому заказу она относится.

Возврат заказа, оплаченного другим методом

Если заказ оплачен картой или другим gateway, store credit refund может быть отдельным процессом. Документация Kestrel описывает сценарий manual refund и дальнейшего ручного credit adjustment, если нужно зачислить сумму на баланс. Это место требует дисциплины: в note указывайте причину и номер заказа, иначе через месяц поддержка не поймет, почему клиенту начислили balance.

Ручные корректировки

Администратор или shop manager может изменить balance пользователя из профиля, если есть соответствующие права. Важно помнить нюанс из документации: в пользовательском профиле вводится новый итоговый balance, а не сумма добавления. Если у клиента было 50, а нужно добавить 25, вводится 75. Это типичная ловушка для менеджеров, которые думают, что поле принимает delta.

Перед ручной корректировкой всегда открывайте transaction history. Если ошибка пришла из cashback rule, лучше исправить rule и сделать корректировку с понятной note, чем просто переписать balance без следа.

Практический сценарий: loyalty credit для повторной покупки

Разберем конкретный сценарий для магазина расходных товаров. Цель - дать покупателю небольшой cashback после первого заказа, показать balance в checkout и разрешить использовать его как частичную оплату следующего заказа. Это хороший старт, потому что он проверяет rewards, transactions, payment gateway и checkout без сложных deposit products.

Цель

Покупатель делает заказ, получает фиксированный store credit после оплаты, видит balance в личном кабинете и применяет его на следующем заказе. Магазин проверяет, что credit появляется только после paid status, а не после простого создания заказа.

Подготовка

1. Создайте отдельный тестовый customer account с email, который не используется в реальных заказах.
2. Включите gateway store credit в WooCommerce - Settings - Payments.
3. Включите partial payment, если хотите, чтобы balance можно было применять к заказам больше остатка.
4. Создайте cashback rule с trigger Order paid, умеренной фиксированной суммой и статусом Active.
5. Если в магазине много скидок, временно исключите coupon orders, чтобы первый тест был проще.

Шаги

1. Зайдите на сайт как тестовый покупатель и оформите обычный заказ через тестовый или ручной метод оплаты.
2. Переведите заказ в статус, который WooCommerce считает оплаченным, если gateway не сделал это автоматически.
3. Откройте Store Credit - Transactions и найдите credit, связанный с заказом.
4. Откройте My Account тестового пользователя и проверьте, что balance отображается.
5. Создайте второй заказ на сумму больше balance и примените store credit на checkout.
6. Оплатите оставшуюся часть другим gateway и проверьте order totals.

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

Успешный результат выглядит так: cashback transaction привязан к первому заказу, balance увеличился, на втором checkout виден available credit, order total уменьшился только на сумму доступного balance, а после оплаты второго заказа transactions показывают debit. В order notes должна быть понятная история списания.

Нюанс

Если cashback не появился, не меняйте rule сразу. Сначала проверьте status заказа, eligibility rules, исключение coupon orders, sale items, award limit и reward budget. Если balance появился, но не применяется в checkout, проверьте gateway enabled, partial payment setting, login status пользователя и то, что вы тестируете не гостевой checkout.

Проверка результата, отчеты и учет outstanding balances

После настройки Account Funds нужно проверять не только внешний checkout, но и внутреннюю отчетность. Store credit - это не просто скидка на следующую покупку. Для магазина это поток начислений и списаний, который влияет на поддержку, аналитику и бухгалтерские ожидания. Именно поэтому transactions screen важнее любого красивого badge на product page.

Минимальный QA-чек-лист

• Создайте test order и не забывайте, что тестовые заказы могут попадать в аналитику и письма WooCommerce.
• Проверьте credit начисление только после нужного статуса заказа.
• Проверьте debit при оплате balance.
• Проверьте refund to store credit и order notes.
• Проверьте, что guest user не получает персональный balance без аккаунта.
• Проверьте, что кеш не показывает чужой balance в header, sidebar или custom page.

Transactions как источник истины

В спорной ситуации transaction history должна отвечать на вопросы: что случилось, когда, с какой суммой, по какому заказу или событию, кто сделал manual adjustment. Если вы вручную меняете balance без reason, плагин может технически сохранить изменение, но поддержке будет трудно объяснить его покупателю.

Outstanding balances

Для prepaid deposits и top-up store должен учитывать, что непотраченные balances являются обязательством перед покупателями. Account Funds и документация Kestrel помогают видеть deposits, usage rates и transaction activity, но интерпретацию для бухгалтерии стоит согласовать отдельно. Не обещайте в пользовательской политике то, что бухгалтерия или локальные правила возвратов не поддерживают.

План поэтапного запуска для живого магазина

Самая частая ошибка при запуске wallet-системы - включить все возможности одновременно. Администратор видит cashback, milestone rewards, top-up, refunds, partial payment, shortcodes и reports, а затем пытается за один вечер собрать "полную программу лояльности". Технически это возможно, но для магазина рискованно: покупатель получает много новых сигналов, поддержка не знает, какой сценарий считать правильным, а accounting не успевает понять, как читать outstanding balances.

Этап 1: только терминология и gateway

На первом этапе настройте label, gateway description и partial payment. Не создавайте rewards. Вручную добавьте небольшую сумму тестовому пользователю и проверьте checkout. Этот этап отвечает на базовый вопрос: может ли buyer увидеть balance, применить его и получить корректный order total. Если здесь есть конфликт с темой, checkout block, payment gateway или кешем, запуск cashback только замаскирует проблему.

Проверьте два заказа: один меньше balance и один больше balance. Первый показывает, как работает полная оплата store credit. Второй показывает, действительно ли partial payment дает доплатить разницу внешним gateway. После каждого заказа откройте transactions и order notes. Если журнал не помогает понять, что произошло, доработайте внутренний процесс поддержки до запуска покупателей.

Этап 2: один простой cashback rule

Когда gateway работает, добавьте один cashback rule. Лучше начать с order paid trigger и простых eligibility rules. Не добавляйте одновременно category bonus, sale item exclusions, coupon restrictions, product-specific rewards и award budget, если вы еще не проверили базовую цепочку. Цель этапа - увидеть, что credit начисляется после paid status и не начисляется для неподходящих заказов.

На этом этапе полезно вести короткую внутреннюю таблицу тестов: какой товар куплен, был ли coupon, какой статус заказа, какой credit ожидался, какая transaction появилась. Это не обязательно делать в статье или интерфейсе, но такой QA-документ быстро выявляет несовпадения между логикой маркетолога и фактическими правилами плагина.

Этап 3: display messages и личный кабинет

Когда начисление работает, включайте display options. Покупателю важно видеть не только сам balance, но и причину: сколько он заработает, где история, как применить credit на следующем заказе. Но не перегружайте product page обещаниями. Если cashback зависит от order amount, coupons или категории, не пишите универсальную фразу "получите credit за любую покупку". Лучше показывать потенциальную награду только там, где условия действительно выполняются.

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

Этап 4: refunds и ручные корректировки

Refunds to store credit запускайте после обучения команды поддержки. Менеджер должен понимать разницу между возвратом на исходный gateway, manual refund и wallet adjustment. Для каждого store credit refund нужен order note и понятный reason. Если customer paid partly with store credit and partly with card, refund split требует особого внимания: часть может вернуться в wallet, часть - в gateway, а decision должен быть зафиксирован.

Ручные корректировки используйте как инструмент поддержки, а не как основной способ начисления. Если вы регулярно вручную добавляете credit за стандартное действие, значит нужно настроить milestone reward или cashback rule. Manual adjustments хороши для исправлений, компенсаций и migration, но не для массовой автоматизации.

Этап 5: prepaid products, B2B и сложные правила

Только после стабильного loyalty flow добавляйте deposit products, top-up limits и B2B budgets. Здесь появляется больше вопросов: должен ли deposit product получать cashback, можно ли refund deposit после частичного расходования credit, какой maximum top-up допустим, как accounting отслеживает обязательства, кто вручную уменьшает corporate balance. Эти вопросы не технические, но они влияют на качество внедрения сильнее, чем внешний вид кнопки на checkout.

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

Коммуникация для покупателей и команды поддержки

Store credit часто ломается не технически, а коммуникационно. Покупатель видит "баланс", но не понимает, можно ли вывести деньги, когда они сгорят, почему credit не применился к заказу с купоном или почему refund выдан не на карту. Поэтому рядом с настройкой плагина должна идти настройка текстов: политика программы, короткие подсказки checkout, FAQ и ответы поддержки.

Что написать покупателю

На странице программы или в FAQ магазина объясните четыре вещи простым языком: как credit начисляется, где посмотреть balance, как применить credit на checkout и в каких случаях credit нельзя использовать. Если есть expiration, minimum order amount, coupon exclusion или product restrictions для rewards, эти условия должны быть написаны заранее. Не прячьте ограничения в мелком тексте, иначе каждый неожиданный отказ от начисления станет обращением в support.

Для checkout description полезна короткая фраза с balance placeholder. Например, customer-facing текст может объяснять, что available store credit уменьшит сумму к оплате, а остаток можно доплатить другим методом, если partial payment включен. В статье не нужно копировать конкретную фразу, но администратор должен проверить ее в интерфейсе, потому что именно она формирует ожидание покупателя.

Что дать поддержке

Поддержке нужен не маркетинговый текст, а диагностическая шпаргалка. В ней должны быть ответы: где открыть transactions, как найти balance в user profile, что означает cashback rule inactive или depleted, как проверить order status, что делать с guest order, как оформить store credit refund и когда нельзя обещать возврат в wallet. Эта шпаргалка сокращает число хаотичных manual adjustments.

Отдельно зафиксируйте фразу для спорных ситуаций: "Мы проверим transaction history and order notes, чтобы увидеть, когда credit был начислен или списан". Это лучше, чем обещать immediate correction до проверки. Если система настроена правильно, transaction history становится источником истины и для покупателя, и для команды.

Shortcodes, вывод баланса и аккуратная визуальная правка

Плагин поддерживает shortcode [store_credit_balance], который показывает balance текущего пользователя. Это полезно для custom My Account pages, header widgets, landing pages программы лояльности и page builder sections. Но персональный balance нельзя бездумно вставлять в каждую кешируемую область сайта.

Где shortcode уместен

Лучшее место - личный кабинет, приватная страница программы лояльности или небольшая строка в header для logged-in users. На публичной landing page shortcode можно использовать как персональный блок: "У вас доступно..." для вошедшего пользователя и обычный призыв войти в аккаунт для гостя.

[store_credit_balance]

Документация Kestrel указывает параметры customer, currency и formatted. Не используйте customer ID на публичных страницах без строгой причины. Обычно нужен balance текущего пользователя, а не произвольного клиента.

CSS для режима credits или points

Kestrel отдельно описывает временный CSS-подход для магазинов, которые используют Account Funds как credit или points-like систему и хотят скрыть символ валюты. Это только визуальная правка. Она не меняет расчеты, валюту или логику хранения. Добавляйте ее через child theme или Additional CSS, а не через правку файлов плагина.

/* Скрывает символ валюты в некоторых выводах Account Funds.
   Используйте только если покупателю ясно объяснено, что означает баланс. */
tr.account-funds .woocommerce-Price-currencySymbol,
.woocommerce-MyAccount-account-funds .woocommerce-Price-currencySymbol {
    display: none;
}

После добавления CSS проверьте My Account, checkout и order tables. Если символ исчез там, где он нужен для понимания денег, откатите правку. Для полноценной points-системы лучше дождаться или использовать специализированный инструмент, а не прятать валюту ради маркетингового названия.

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

Большинство проблем с Account Funds сводится к одному из пяти мест: пользователь не вошел в аккаунт, order status не достиг нужного состояния, eligibility rule исключает заказ, gateway выключен или персональный balance закешировался как статический фрагмент. Ниже - практическая диагностика, которую удобно дать поддержке и администратору магазина.

Cashback не начислился после заказа

Симптом: покупатель оплатил заказ, но balance не увеличился. Возможные причины - заказ не перешел в paid status, reward inactive, order не соответствует eligibility, сработал exclusion для coupons или sale items, исчерпан award budget, reward expired или customer уже достиг once-per-customer limit.

Проверьте order status, transactions screen, настройки конкретного cashback rule и order notes. Если правило корректное, повторите тест на новом заказе с простым товаром без купона. Если credit появился, проблема в eligibility. Если не появился, проверьте статус reward и совместимость checkout/payment flow.

Top-up не появился в личном кабинете

Симптом: пользователь не видит форму пополнения. Возможные причины - top-up выключен в settings, пользователь не вошел в аккаунт, My Account page построена кастомным редактором и не выводит стандартный endpoint, кеш отдает старую версию страницы.

Откройте страницу как logged-in test customer, временно переключитесь на стандартную тему или стандартный My Account layout, очистите кеш и проверьте endpoints в WooCommerce - Settings - Advanced. Если кастомный My Account editor скрывает endpoint, настройте его так, чтобы раздел store credit оставался доступен.

Store credit не применяется на checkout

Симптом: balance виден, но покупатель не может использовать его в заказе. Проверьте, включен ли gateway в payments settings. Если partial payment выключен, balance должен покрывать весь order total, иначе gateway может не появиться. Если checkout блоковый, проверьте, что тема и checkout extensions не скрывают payment method area.

Для проверки создайте заказ меньше balance и второй заказ больше balance. Первый должен пройти как full store credit payment, второй - только если partial payment включен. Если первый не работает, проблема скорее в gateway. Если первый работает, а второй нет, смотрите partial payment.

Баланс в шапке показывает чужую сумму или пустой вывод

Симптом: shortcode в header, sidebar или custom page показывает неверный balance, старый balance или ничего. Причина часто в page cache, guest state или неправильном условии вывода. Shortcode возвращает персональные данные, поэтому обычный статический кеш может быть опасен.

Исключите блок или страницу из кеша для logged-in users, проверьте вывод на чистой сессии, уберите hardcoded customer parameter и используйте balance текущего пользователя. Если используется page builder, проверьте, не сохраняет ли он rendered shortcode как статический HTML.

Refund не попал в wallet

Симптом: менеджер оформил возврат, но customer balance не изменился. Возможные причины - refund был отправлен на исходный gateway, выбран manual refund без отдельной корректировки wallet, заказ гостевой и не связан с аккаунтом, либо order note не отражает store credit action.

Откройте order notes, refund details и user profile. Если customer не имеет аккаунта, store credit привязать не к чему. Если был manual refund, добавьте balance корректировку с note, где указан order number и причина. Если процесс часто повторяется, обучите поддержку выбирать правильный refund flow.

У покупателя отрицательный или неожиданный balance

Симптом: balance стал меньше ожидаемого или ушел в минус после refund deposit product. Это может случиться, если customer купил deposit, получил credit, успел потратить часть, а затем order с deposit product был refunded и система попыталась reversing deposit.

Перед refund deposit orders проверяйте текущий wallet. Если часть credit уже потрачена, решайте ситуацию вручную и фиксируйте note. Не делайте blind refund без проверки transactions, иначе support получит спор по отрицательному balance.

Ограничения, безопасность и правила запуска на живом магазине

Account Funds работает с деньгами или денежно-похожими остатками, поэтому запускать его нужно постепенно. Начните с staging site, где можно выполнить тестовые заказы без реальных списаний. Документация WooCommerce по testing orders напоминает, что тестовые заказы могут запускать письма, аналитику и сторонние интеграции, поэтому на живом магазине тесты нужно проводить осторожно.

Guest checkout и аккаунты

Store credit привязан к user account. Если в магазине разрешен guest checkout, покупатель без аккаунта не сможет иметь wallet balance. Для loyalty-программы это нормально: можно мотивировать регистрацию welcome bonus. Для магазинов, где аккаунты нежелательны, это ограничение делает плагин менее полезным.

Мультивалютность

Официальные и сторонние обсуждения показывают, что store credit и currency switchers требуют отдельной осторожности. В документации shortcode есть параметр currency, а feature requests указывают на вопросы конвертации. Не запускайте крупные балансы в мультивалютном магазине без теста: начислите credit в одной валюте, переключите валюту на checkout и проверьте расчеты, order notes и остаток.

Права доступа

Управление балансами должно быть доступно только администраторам и shop managers или ролям с нужной capability. Если вы создаете custom role для поддержки, проверьте, какие действия она может выполнять: видеть balances, менять balances, делать refunds, смотреть orders. Не давайте права шире, чем нужно.

HPOS и расширения checkout

На новых магазинах HPOS может быть активен, а старые магазины могут включать его постепенно. Официальная документация WooCommerce рекомендует проверять совместимость расширений и держать данные синхронизированными при переходе. Так как Account Funds работает с заказами, тестируйте order storage, subscriptions и checkout extensions вместе, а не по отдельности.

Когда WooCommerce Account Funds будет удачным выбором

WooCommerce Account Funds стоит использовать, если магазину нужен управляемый store credit, а не просто набор купонов. Сильные стороны плагина раскрываются там, где balance входит в рабочий процесс: cashback после paid order, milestone reward за регистрацию или отзыв, top-up из личного кабинета, deposit products, partial payment на checkout, refunds to store credit и ручная поддержка customer balances.

Перед запуском выберите один главный сценарий. Для loyalty-магазина это может быть простой cashback и partial payment. Для B2B - deposit products, top-up limits и отчетность. Для поддержки - refund to store credit и понятные notes. Не включайте все функции сразу, если команда не готова объяснить их покупателю и проверить transactions.

Если после тестов gateway, rewards, checkout и refunds работают предсказуемо, можно скачать WooCommerce Account Funds и внедрять его на рабочем сайте поэтапно: сначала настройки и один reward, затем top-up или refunds, затем дополнительные правила и shortcodes.

Хорошо настроенный Account Funds делает страницу продукта и сам магазин понятнее: покупатель видит, за что получил credit, как его потратить и где проверить остаток. А администратор получает журнал, по которому можно восстановить каждое начисление и списание без догадок.