Booknetic Square Payment Gateway - Плагин WordPress

Руководство по настройке Booknetic Square Payment Gateway для приема оплат за записи

Booknetic Square Payment Gateway нужен не для замены всего модуля бронирования, а для одного конкретного участка: клиент выбирает услугу в Booknetic, доходит до шага оплаты и может рассчитаться через Square. В этом руководстве разберем, как встроить аддон в уже подготовленную систему записи, какие платежные параметры проверить до включения и как понять, что деньги, статус оплаты и сама запись связались корректно.

Материал рассчитан на владельца сайта, администратора WordPress или специалиста, который отвечает за онлайн-запись в салоне, студии, консультационном кабинете, сервисном центре, фитнес-клубе или другой компании с бронированием времени. Мы не будем повторять рекламное описание продукта, а пройдем путь от подготовки Booknetic и Square до тестовой записи, диагностики ошибок и выбора альтернативного платежного сценария.

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

Какую задачу закрывает платежный аддон Square

Booknetic Square Payment Gateway добавляет в Booknetic отдельный способ онлайн-оплаты. Клиент не просто отправляет заявку на запись, а завершает бронирование с платежом. После успешной оплаты Booknetic фиксирует запись и платежный статус, а администратор получает более понятную финансовую картину в разделе оплат.

По официальному описанию Booknetic, Square включается в пути General Settings - Payment settings - Payment methods. После включения нужно указать данные Square-аккаунта. Это важная деталь: аддон не создает платежный аккаунт за владельца сайта и не заменяет проверку продавца на стороне Square. Он связывает уже существующую платежную инфраструктуру с формой записи Booknetic.

В реальном рабочем процессе участвуют три слоя:

• Booknetic отвечает за услуги, сотрудников, расписание, шаги формы записи и внутренние платежные статусы.
• Square отвечает за обработку карточного или другого доступного платежа в своем платежном контуре.
• WordPress отвечает за страницу, где размещен блок бронирования, а также за совместимость темы, кеша и других плагинов.

Из-за этой связки диагностику нельзя сводить к вопросу «включен ли Square». Иногда ошибка возникает из-за неверной валюты, неподготовленной услуги, неактивного продавца в Square, смешения тестовых и боевых учетных данных, агрессивной оптимизации скриптов или неправильного ожидания оплаты в Booknetic.

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

Кому подходит Booknetic Square Payment Gateway и когда лучше выбрать другой маршрут

Аддон особенно полезен компаниям, которые уже используют Square в офлайн-точке, хотят видеть платежи в привычной панели Square и не хотят переводить запись в WooCommerce только ради приема оплаты. Для таких сайтов важна короткая цепочка: клиент выбирает услугу, время, сотрудника, вводит данные и платит без лишнего магазина вокруг записи.

Подходит сервисным бизнесам с понятной ценой услуги

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

Подходит сайтам, где платеж должен быть частью записи

Booknetic умеет вести модуль оплат и отображать статусы вроде оплачено, ожидание, неоплачено и отменено. Это важно, если расписание ограничено и владелец не хочет держать слот бесконечно после незавершенного платежа. Настройка ожидания оплаты помогает освободить время, если клиент начал бронирование, но не завершил расчет.

Может не подойти при сложной корзине и товарах

Если запись должна идти вместе с физическими товарами, доставкой, купонами WooCommerce, сложными налоговыми правилами магазина или большим набором платежных методов, прямой Square-аддон может быть слишком узким. В таком случае логичнее проверить WooCommerce-интеграцию Booknetic: Booknetic передает запись в WooCommerce checkout, а платежные методы зависят уже от WooCommerce.

Может не подойти без поддерживаемого Square-сценария

Square доступен не для любого продавца и не для любого набора платежных методов. Перед настройкой проверьте страну продавца, валюту, требования Square к аккаунту и возможность использовать нужный тип платежа. Если Square не подходит регионально или юридически, лучше не пытаться строить рабочий процесс вокруг него. В таком случае посмотрите Stripe, PayPal, Mollie, Razorpay, WooCommerce-маршрут или локальную оплату в Booknetic.

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

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

Техническая база WordPress и Booknetic

Официальные требования Booknetic включают подходящую версию PHP, MySQL, право пользователя базы данных на создание таблиц и включенное расширение cURL. Для платежного сценария cURL особенно важен, потому что интеграции и внешние запросы без него часто ведут себя нестабильно. На хостинге также должен быть HTTPS, потому что платежная форма и персональные данные клиента не должны передаваться через небезопасное соединение.

• Проверьте, что основной Booknetic установлен, активирован и открывается в меню WordPress.
• Проверьте, что сайт работает по HTTPS без смешанного содержимого на странице записи.
• Проверьте, что хостинг не блокирует исходящие запросы к платежным сервисам.
• Проверьте, что кеш и оптимизация JavaScript не ломают многошаговую форму бронирования.

Базовые данные для записи

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

Особое внимание уделите приоритету расписаний. В документации Booknetic расписание сотрудника имеет самый высокий приоритет, расписание услуги ниже, а общие рабочие часы ниже всех. Если администратор видит странные недоступные слоты, сначала проверьте не Square, а рабочее время сотрудника, время услуги и дни отдыха.

Square-аккаунт и учетные данные

Для связки с Square обычно нужны данные приложения и продавца из Square Developer Console или Square Dashboard. В разных интеграциях названия полей могут отличаться, но чаще встречаются идентификатор приложения, токен доступа, идентификатор локации и режим окружения. Booknetic на своей странице Square говорит об указании данных Square-аккаунта, поэтому перед настройкой подготовьте учетные данные заранее и не храните их в заметках, доступных редакторам сайта.

Не смешивайте тестовые и боевые данные. Если в платежном сервисе используется тестовая среда, а в Booknetic выбран рабочий режим, платежи могут отклоняться без очевидной причины. Такая ошибка часто выглядит как проблема аддона, хотя на деле не совпадают окружения.

Валюта, формат цены и ожидание оплаты

В Payment settings Booknetic задаются валюта, символ валюты, формат цены, количество десятичных знаков и время ожидания оплаты. Эти параметры влияют на то, что клиент видит в форме, как формируется сумма и как долго слот остается занятым при незавершенном платеже.

Для первого запуска не меняйте все параметры одновременно. Сначала выставьте валюту, формат цены и время ожидания оплаты, затем выполните одну тестовую запись. Если результат корректный, переходите к дополнительным настройкам услуг, предоплат, уведомлений и счетов.

Установка через Boostore и первичная проверка в WordPress

Booknetic развивает официальные аддоны через Boostore. Документация описывает Boostore как встроенный каталог, где администратор может найти нужный аддон, открыть детали, добавить его и затем установить из раздела покупок. Для Square это удобнее ручного ZIP-подхода, потому что аддон остается частью экосистемы Booknetic и управляется из того же интерфейса.

Порядок включения без лишних действий

1. Откройте админ-панель WordPress и перейдите в раздел Booknetic.
2. Откройте Boostore и найдите Square Payments или Square Payment Gateway.
3. Проверьте, что это официальный аддон для Booknetic, а не сторонняя копия из неизвестного источника.
4. После добавления перейдите в My Purchases и установите аддон штатной кнопкой Install.
5. Вернитесь в настройки Booknetic и убедитесь, что Square появился среди платежных методов.

Если Square не появился в платежных методах после установки, не переходите сразу к удалению и повторной установке. Сначала обновите страницу, проверьте права текущего администратора, убедитесь, что основной Booknetic активен, и посмотрите, не скрыты ли элементы меню из-за роли пользователя или настройки боковой панели.

Первичная проверка после установки

После установки откройте Settings - Payment Settings - Payment Methods. Square должен быть доступен как отдельный способ оплаты. На этом этапе не обязательно сразу принимать реальный платеж. Достаточно убедиться, что переключатель включается, поля сохраняются и после обновления страницы не сбрасываются.

Если Booknetic сообщает об ошибке сохранения, проверьте консоль браузера только как вспомогательный инструмент, а не как единственный источник. Часто проблема находится в серверном ответе: конфликт безопасности, блокировка AJAX, ошибка прав, устаревший кеш админки или недоступность внешнего API.

Карта платежных настроек: что включать первым

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

Базовая таблица настроек

Эта таблица помогает не потеряться в параметрах, которые обычно проверяют при первом запуске платежного сценария.

Какие значения выбрать для типового сайта

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

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

Что не стоит включать без причины

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

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

Square в реальном потоке бронирования: от услуги до статуса оплаты

Платежный аддон проще понять как цепочку событий. Клиент не «оплачивает плагин» и не «покупает услугу в вакууме». Он проходит шаги Booknetic, а Square включается в момент, когда у записи уже есть услуга, цена, сотрудник и слот времени.

Входные данные: услуга, цена и доступность

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

Платежный шаг: выбор метода и передача суммы

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

Выход: запись и платежный статус

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

Для администратора это важнее, чем сам факт появления кнопки Square. Рабочая интеграция подтверждается не наличием метода оплаты в настройках, а связкой «тестовая запись создана - платеж обработан - статус понятен - слот не зависает».

Как связать платежный сценарий с ценовой логикой услуги

У Booknetic цена не всегда равна одному полю «стоимость услуги». На итог могут влиять дополнительные услуги, staff-based pricing, депозитные настройки и условные цены, если они включены в вашей конфигурации. Square получает сумму уже после того, как Booknetic рассчитал запись. Поэтому при спорной сумме сначала ищите источник в Booknetic, а не в платежном провайдере.

Базовая услуга без условий

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

Услуга с дополнительными опциями

Если клиент выбирает extra service, сумма и иногда длительность записи меняются. Проверьте, видит ли клиент обновленный итог до оплаты, отображается ли он в Booknetic Payments и совпадает ли с платежом в Square. Если сумма меняется только после выбора опции, это нормальное поведение, но его нужно ясно проверить до публикации.

Условная цена или скидка

Conditional Prices могут применять доплату или скидку по услуге, сотруднику, локации, дню недели, длительности и другим условиям. Для платежного аддона это не отдельная функция Square, а входная сумма от Booknetic. Если правило дает неожиданный результат, временно выключите его и повторите тест. Так вы отделите ошибку оплаты от ошибки ценообразования.

Такая декомпозиция экономит много времени. Администратор видит, какой слой отвечает за результат: Booknetic рассчитывает услугу, Square обрабатывает оплату, а модуль Payments показывает, как Booknetic понял итог платежа.

Практический сценарий: предоплата консультации через Square

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

Цель

Получить простой рабочий сценарий, где одна услуга Booknetic оплачивается через Square, а результат проверяется в модуле оплат. Такой сценарий удобен для первого запуска, потому что он не смешивает несколько локаций, разных сотрудников, сложные скидки и групповую запись.

Подготовка

• Создайте или выберите одну услугу с фиксированной ценой и понятной длительностью.
• Назначьте услуге одного сотрудника и проверьте его рабочее время.
• Убедитесь, что на странице WordPress размещен блок бронирования Booknetic.
• Включите Square в платежных методах и сохраните учетные данные.
• Проверьте валюту и время ожидания оплаты.

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

1. Откройте Services в Booknetic и выберите услугу для проверки.
2. Проверьте цену, длительность и буферное время. Для теста оставьте один понятный тариф.
3. На вкладке сотрудников убедитесь, что услуга связана с доступным сотрудником.
4. Откройте Settings - Payment Settings и проверьте валюту.
5. В Payment Methods включите Square и сохраните настройки.
6. Откройте страницу с формой записи в приватном окне браузера.
7. Выберите услугу, сотрудника, дату и время, затем дойдите до шага оплаты.
8. Выберите Square, завершите тестовый платеж и дождитесь возврата в Booknetic.

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

После теста откройте модуль оплат в Booknetic. Найдите платеж по клиенту, времени или сумме. Убедитесь, что статус соответствует результату оплаты, а запись не осталась в подвешенном состоянии. Затем откройте список записей и календарь, чтобы проверить, что слот занят именно тестовой записью.

Мини-итог проверки: если платеж есть в Square, но в Booknetic статус остался в ожидании, ищите проблему связи статуса, возврата или серверного запроса. Если платежа нет ни в Square, ни в Booknetic, проверьте учетные данные, режим окружения и доступность платежного шага.

Как тестировать без путаницы в реальных заявках

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

Что записать в журнал проверки

Для каждого теста зафиксируйте услугу, сумму, выбранного сотрудника, время записи, способ оплаты, статус в Booknetic и наличие платежа в Square. Это не бюрократия, а быстрый способ увидеть, где именно разошлись данные. Если позже клиент сообщит о проблеме, у вас уже будет эталонная проверка, с которой можно сравнить новый случай.

Как отличить тестовую ошибку от пользовательской

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

Нюанс с шорткодом и отдельной страницей услуги

Если на сайте много услуг, для теста удобно вывести форму только с одной услугой или одним сотрудником. Документация Booknetic подтверждает шорткоды с фильтрами по услуге, сотруднику, категории и локации. Это помогает не тестировать весь каталог сразу.

[booknetic service=ID]
[booknetic staff=ID service=ID]
[booknetic category=ID location=ID]

После проверки замените ID на реальные значения из интерфейса Booknetic. Если на странице используется кеш, очистите кеш страницы и проверьте форму в приватном окне. Если шорткод показывает не ту услугу, сначала перепроверьте ID, затем наличие услуги в расписании и назначение сотрудника.

Практичные идеи применения для разных типов сервисного сайта

Square-аддон можно использовать не только как кнопку оплаты. Он помогает выстроить разные модели записи, если они честно опираются на функции Booknetic: услуги, цену, сотрудников, расписание, платежные статусы, дополнительные услуги, workflow и отдельные страницы с шорткодами.

Снизить неявки через обязательную предоплату

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

Разделить страницы для разных услуг

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

Упростить учет для администратора

Модуль оплат Booknetic показывает платежи и их статусы, а Square дает свою сторону финансового учета. Администратору полезно сверять обе системы: в Booknetic проверяется связь с записью и календарем, в Square - факт обработки платежа и данные продавца. Такой подход особенно важен, если есть отмены, переносы или частичные оплаты.

Запустить отдельный тестовый маршрут перед расширением

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

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

Проверка должна охватывать не только платеж. В рабочей связке есть публичная часть сайта, Booknetic, Square и уведомления. Если проверить только одну сторону, можно пропустить неприятный сценарий: клиент заплатил, но письмо не ушло; запись создана, но платеж остался в ожидании; Square принял платеж, но администратор не видит его в Booknetic.

Контрольный список после тестовой оплаты

• На странице записи клиент видит корректную услугу, цену и доступное время.
• Square появляется только там, где онлайн-оплата действительно нужна.
• После платежа пользователь получает понятный результат, а не остается на пустом шаге.
• В Payments Booknetic виден платеж с ожидаемым статусом.
• В календаре Booknetic слот занят тестовой записью.
• В Square Dashboard можно найти соответствующий тестовый или рабочий платеж.
• Workflow-уведомления уходят по событию записи или оплаты, если они настроены.

Что считать успешным запуском

Успешный запуск - это не один удачный платеж администратора. Проведите несколько проверок: успешная оплата, прерванная оплата, запись с возвратом назад в форме, запись с другим сотрудником, запись с другой ценой, если на сайте есть такие варианты. После каждой проверки смотрите не только страницу клиента, но и модуль оплат.

Не переносите настройку на весь сайт, пока не понятен результат каждого теста. Лучше потратить время на один небольшой сценарий, чем включить Square на десятки услуг и потом выяснять, где именно сумма или статус ведут себя неправильно.

Сверка Booknetic и Square после первых реальных платежей

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

Ежедневная сверка для малого бизнеса

Если записей немного, достаточно короткой ежедневной проверки: открыть Booknetic Payments, отфильтровать платежи за день, сравнить их с Square Dashboard и отметить спорные случаи. Особое внимание уделяйте платежам в ожидании, отмененным платежам и записям, которые клиент переносил после оплаты.

Что делать при расхождении

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

Когда нужна поддержка

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

Уведомления и документы после оплаты

В Booknetic workflow может срабатывать на событие оплаты записи, а модуль счетов может прикреплять документы к уведомлениям. Если бизнес отправляет клиенту чек, счет или подтверждение, проверьте эти элементы отдельно. Платежный аддон не гарантирует, что текст письма, вложения и шаблон счета уже настроены корректно.

Диагностика: почему Square может не работать в форме записи

Ошибки платежей часто выглядят одинаково: клиент не видит метод, платеж не проходит, статус зависает или запись не подтверждается. Но причины разные, и исправлять их нужно по порядку. Ниже - практическая карта диагностики для Booknetic Square Payment Gateway.

Square не отображается среди методов оплаты

Симптом: администратор включил аддон, но клиент на шаге оплаты не видит Square.

Сначала проверьте, установлен ли аддон через Boostore и появился ли Square в Payment Methods. Затем убедитесь, что метод включен и настройки сохранены. Если на сайте есть несколько страниц записи, очистите кеш именно той страницы, где проверяете форму. Если Square нужен только для отдельных услуг, проверьте, не ограничили ли вы платежный метод на уровне услуги или сценария.

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

Платеж не проходит после ввода данных

Симптом: клиент выбирает Square, но платеж отклоняется или форма не завершает процесс.

Проверьте режим окружения и учетные данные. Тестовые данные должны использоваться в тестовом окружении, боевые - в рабочем. Затем проверьте Square-аккаунт, страну продавца, валюту и доступность платежного метода. Если платежный сервис требует завершенной проверки продавца, рабочие платежи могут не пройти до окончания проверки.

Откат: вернитесь к простому тесту с одной услугой и минимальной суммой. Если ошибка повторяется, смотрите события в Square Dashboard и серверные журналы WordPress, но не публикуйте секретные токены в тикетах и переписке.

Запись создана, но платеж остался в ожидании

Симптом: клиент дошел до платежа, но в Booknetic статус не стал оплаченным.

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

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

Сумма в Square не совпадает с ожиданием

Симптом: клиент видит одну сумму, а в платежном сервисе или в Booknetic итог кажется другим.

Проверьте цену услуги, дополнительные услуги, депозитные настройки, условные цены, скидки и формат валюты. В Booknetic дополнительные услуги могут добавлять стоимость и длительность, а условные цены могут менять сумму по правилам. Для диагностики временно отключите все правила и проверьте базовую услугу.

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

Форма ломается после оптимизации или кеша

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

Проверьте минификацию, отложенную загрузку JavaScript, объединение скриптов и кеш страницы. Многошаговые формы бронирования чувствительны к оптимизации. Не нужно отключать весь кеш сайта навсегда, но страницу записи и критичные скрипты Booknetic стоит исключить из агрессивной оптимизации, если после нее ломается платежный шаг.

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

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

Платежный сценарий связан с деньгами и персональными данными, поэтому улучшения должны быть осторожными. Для Booknetic Square Payment Gateway не стоит придумывать собственные PHP-хуки или править файлы плагина, если они не подтверждены документацией. Безопаснее использовать настройки Booknetic, отдельную тестовую страницу, шорткоды, исключения кеша и workflow-уведомления.

Что можно улучшить без кода

• Создать отдельную тестовую страницу с шорткодом одной услуги, чтобы проверить Square без влияния всего каталога.
• Настроить workflow на событие оплаты записи, чтобы администратор получал отдельное уведомление о платеже.
• Подготовить короткое пояснение рядом с формой записи: когда списывается оплата, что делать при отмене и как связаться с администратором.
• Исключить страницу записи из агрессивной минификации и отложенной загрузки скриптов, если платежный шаг нестабилен.
• Проверить счет или подтверждение записи, если бизнес отправляет клиенту финансовый документ после оплаты.

Где не стоит экспериментировать

Не редактируйте ядро WordPress, файлы Booknetic, файлы аддона Square и платежные запросы вручную. Не храните токены Square в пользовательских полях страницы, в видимых заметках или в материалах, которые доступны контент-менеджерам. Не скрывайте ошибки платежа через CSS или JavaScript: если клиент не видит сообщение, администратор получает больше спорных записей.

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

Когда Booknetic Square Payment Gateway будет удачным выбором

Booknetic Square Payment Gateway стоит использовать, если ваш сайт уже работает на Booknetic, услуги имеют понятную цену, клиенту удобно платить во время записи, а Square подходит вашему бизнесу как платежный провайдер. В таком сценарии аддон закрывает конкретную и полезную задачу: связывает онлайн-бронирование, платеж и статус записи без переноса всего процесса в магазинную корзину.

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

Если вы уже решили проверить аддон на своем сайте, переходите к блоку загрузки и загрузить архив с Booknetic Square Payment Gateway. После установки не включайте его сразу на весь каталог услуг: начните с одной страницы, одного сотрудника и одной тестовой записи, а затем переносите проверенную схему на реальные сценарии.