Документация ComusThumbz
Вход для Администратора

Биллинг Логс

Что делает эта страница

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

[Скриншот: обзор страницы]


Как добраться сюда

Навигация для Панель администратора Биллинг Лог


Понимание страницы

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

Статистика бара

В верхней части страницы четыре цветные карты дают вам краткое описание вашей активности в журнале:

КартаЧто это показывает
Полный логОбщее количество записей журнала (зеленый акцент)
Отладочные сообщенияПодробные записи фоновой активности (серый акцент)
Информационные сообщенияОбычные операционные сообщения, такие как успешные платежи (синий акцент)
сообщения об ошибкахПроблемы, требующие вашего внимания (красный акцент)
Совет: Следите за количеством сообщений об ошибках. На здоровом сайте ошибки должны составлять менее 5% от общего количества журналов. Если вы видите ошибки при подъеме, немедленно исследуйте.

[Скриншот: биллинг-логи-статусы]

Панель фильтров

Ниже панели статистики вы найдете фильтры, которые позволяют сузить, какие записи журнала вы видите. Вы можете отфильтровать поставщика платежей, тип сообщения, поиск по ключевым словам и диапазон дат. Более подробная информация об использовании фильтров приведена в разделе Общие задачи ниже.

Запись

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

колоннаЧто это показывает
IDУникальный номер для входа
Дата/времяКогда событие произошло
поставщикК какому поставщику платежей причастны
ТипЯвляется ли запись отладкой, информацией или сообщением об ошибке
ПосланиеКраткое изложение того, что произошло
ПодробностиДополнительная информация (поверх этой колонки, чтобы увидеть полный контент)

Ряды имеют цветовую кодировку, поэтому вы можете быстро обнаружить проблемы:

  • Красный фон Ошибки, которые могут потребовать вашего внимания
  • Серый фон - Отладочные записи с техническими деталями
  • Белый фон Нормальные информационные записи

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

Кнопки действия

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


Общие задачи

Как просматривать последние журналы

  1. Пойти Панель администратора Биллинг Лог.
  2. Страница автоматически отображает самые последние записи.
  3. Прокрутите таблицу для обзора деятельности.
  4. Нависать над Подробности столбец на любой строке, чтобы увидеть полные детали этой записи.

Как фильтровать платежную систему

Используйте это, когда вы хотите видеть активность только от одного поставщика платежей (например, только PayPal или только Stripe).

  1. Выберите поставщика из Платежный провайдер выпадаю.
  2. щелкнуть Применять фильтры.
  3. Обновление таблицы и статистических карт показывает только записи от этого поставщика.

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

Как фильтровать по типу сообщения

Используйте это, чтобы сосредоточиться на определенном типе записи журнала.

  1. Выберите тип из Тип сообщения выпадение:
  • отладка - Справочные технические детали
  • информация Нормальные события, такие как успешные платежи
  • ошибка Проблемы, требующие внимания
  1. щелкнуть Применять фильтры.

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

Как фильтровать по диапазону дат

Используйте это для просмотра журналов за определенный период времени.

  1. Кликни Дата выхода поле и выбрать дату начала.
  2. Кликни Дата для поле и выбрать дату окончания.
  3. щелкнуть Применять фильтры.
  4. В таблице показаны только записи из этого диапазона дат (обе даты полностью включены).

Как искать логи

Используйте это, когда вы ищете что-то конкретное, например, определенное ключевое слово или номер ссылки.

  1. Введите свой поисковый запрос в Поисковые сообщения поле.
  2. щелкнуть Применять фильтры.
  3. Результаты показывают записи, где ваш поисковый запрос появляется в сообщении или в деталях.

Полезные поисковые термины, чтобы попробовать:

Поиск дляНайти
webhookДоставка платежных уведомлений
failedОперации, которые не завершились
subscriptionМероприятия, связанные с подпиской
amountЗаписи с указанием сумм оплаты

Как комбинировать несколько фильтров

Вы можете использовать все фильтры одновременно для целенаправленного поиска.

  1. Выберите Платежный провайдер.
  2. Выберите Тип сообщения.
  3. Установить Дата выхода и Дата для диапазон.
  4. Введите ключевое слово в Поисковые сообщения.
  5. щелкнуть Применять фильтры.

Появятся только записи, соответствующие всем вашим критериям, и карты статистики будут обновляться.

Как очистить все фильтры

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

Навигация между страницами

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

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


В нижней части страницы три кнопки позволяют перейти в смежные области:

КнопкаКуда тебя забирает
Управлять поставщикамиСтраница, на которой вы настраиваете своих поставщиков платежей
Управление пакетамиСтраница, на которой вы настроили пакеты подписки и доступа
Посмотреть ТранзакцииСтраница, показывающая индивидуальные платежные операции

Советы для новых пользователей

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


Мониторинг вашего платежного здоровья

Вот простой график, чтобы ваши платежи работали гладко:

Как частоЧто проверить
ежедневноПосмотрите на количество ошибок - есть ли новые ошибки за последние 24 часа?
ежедневноВзгляд на общий объем журнала - ваш сайт записывает платежи, как ожидается?
еженедельноСравните уровень ошибок на этой неделе с прошлой неделей - он растет или падает?
ежемесячноПросмотрите деятельность каждого поставщика платежей, чтобы убедиться, что все они работают.

Понимание ставок ошибок

Ставка ошибкиЧто это значитЧто делать
Менее 1%Все это здоровоПродолжайте нормальный мониторинг
От 1% до 5%Незначительные проблемы могут существоватьПосмотрите на верхние ошибки и посмотрите, есть ли шаблон.
От 5% до 10%Что-то требует вниманияНемедленно просмотрите ошибки и проверьте настройки вашего провайдера
Более 10%Серьезная проблемаОстановитесь и исследуйте, прежде чем это повлияет на ваш доход.
Предупреждение: Если ваш уровень ошибок внезапно превысит 10%, немедленно проверьте настройки поставщика платежей. Общие причины включают просроченные учетные данные, измененные адреса веб-хуков или отключения провайдера.

Распознавание общих шаблонов журналов

Успешный платеж выглядит так

Вы увидите ряд информационных сообщений по порядку:

  1. Уведомление, полученное от поставщика платежей
  2. Уведомление успешно проверено
  3. Транзакция, созданная для пользователя
  4. Обновленная подписка или доступ

Успех: Когда вы видите этот шаблон, ваша платежная система работает правильно.

Неудачный платеж выглядит так

Вы увидите одно или несколько сообщений об ошибках, часто с сообщением Info до или после:

  1. Уведомление, полученное от поставщика платежей
  2. Ошибка, указывающая на то, что пошло не так (например, «отказ в оплате» или «проверка не удалась»)

Что делать, если вы видите ошибки

  1. Фильтр по Тип сообщения: Ошибка Посмотреть все недавние ошибки.
  2. Ищите шаблоны — все ли ошибки от одного и того же провайдера? Тот же тип сообщения?
  3. Нависать над Подробности столбец для получения дополнительной информации о каждой ошибке.
  4. Действуйте, основываясь на том, что вы найдете:
Паттерн ошибокЧто делать
«Недействительный ключ API» или «подпись не удалось»Перейдите к настройкам вашего поставщика платежей и убедитесь, что ваши учетные данные верны.
«Оплата снизилась»Это нормально - это означает, что способ оплаты клиента был отклонен их банком.
"Время соединения"Обычно это временно. Если это происходит, у вашего сервера может возникнуть проблема с подключением - свяжитесь с вашим хостинг-провайдером.
«Пользователь не найден»Оплата за учетную запись пользователя, которой не существует. Проверьте, был ли удален аккаунт клиента

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

Записи журнала не появляются

Что вы видите: Страница загружается, но таблица пуста, и вся статистика показывает ноль.

Как это исправить:

  1. Убедитесь, что у вас есть хотя бы один поставщик платежных услуг. Пойти Панель администратора Billing > Платежные провайдеры и проверить.
  2. Если вы просто настроили своих поставщиков платежей, журналы появятся только после того, как произойдет реальная платежная деятельность (тестовая транзакция, веб-хук от вашего поставщика и т. Д.).
  3. Убедитесь, что ваши фильтры не слишком жесткие. щелкнуть сброс Очистите все фильтры и посмотрите, появятся ли записи.

Колонка Детали не расширяется, когда я парю над ней.

Что вы видите: Вы парите над усеченной записью в столбце Детали, но она не расширяется.

Как это исправить:

  1. Попробуйте обновить страницу.
  2. Попробуйте другой веб-браузер, чтобы увидеть, сохраняется ли проблема.
  3. Если запись показывает «Нет дополнительных деталей», больше ничего не видно для этой записи — она просто не имеет дополнительной подробной информации.

Поставщик платежей показывает номер вместо имени

Что вы видите: В столбце Провайдера вы видите номер (например, «3») вместо имени поставщика.

Как это исправить:
Это происходит, когда поставщик платежей был удален из ваших настроек, но его записи журнала все еще существуют. Журналы все еще действительны - система просто не может больше искать имя поставщика. Это не влияет на работу вашего сайта.

Фильтры, похоже, не работают

Что вы видите: Вы используете фильтры, но результаты не кажутся правильными.

Как это исправить:

  1. щелкнуть сброс Очистить все фильтры.
  2. Применяйте только один фильтр за раз, чтобы сузить, какой фильтр может вызвать путаницу.
  3. Дважды проверьте свой диапазон дат - убедитесь, что Дата выхода Перед тем, как Дата для.


СтраницаКогда его использовать
Платежные провайдерыНастроить или изменить настройки вашего платежного процессора (учетные данные, адреса веб-хуков и т. Д.)
Биллинговые сделкиЧтобы увидеть отдельные платежные операции, возвраты и сборы за подписку
Пакеты доступаСоздать или отредактировать планы подписки и варианты одноразовой покупки, доступные на вашем сайте