ComusThumbz Documentation
HTML Markdown Print/PDF Plain Text
Admin Login

Documentation Menu


Admin Access

Billing Logs

 

What This Page Does

This page shows you a record of everything that happens between your site and your payment providers. Every time a payment is processed, a subscription is renewed, or something goes wrong with a transaction, it gets recorded here. Use this page to check that payments are working correctly and to investigate any issues.

[Screenshot: page-overview]

How to Get Here

Navigate to Admin Panel > Billing > Logs

Understanding the Page

When you open this page, you will see four main areas: a statistics bar at the top, a set of filters below it, the main log table, and navigation buttons at the bottom.

Statistics Bar

At the top of the page, four colored cards give you a quick summary of your log activity:

Card What It Shows
Total Logs The total number of log entries (green accent)
Debug Messages Detailed background activity records (gray accent)
Info Messages Normal operational messages like successful payments (blue accent)
Error Messages Problems that need your attention (red accent)
Tip: Keep an eye on the Error Messages count. On a healthy site, errors should make up less than 5% of your total logs. If you see errors climbing, investigate right away.

[Screenshot: billing-logs-stats]

Filter Panel

Below the statistics bar, you will find filters that let you narrow down which log entries you see. You can filter by payment provider, message type, a keyword search, and a date range. More details on using filters are in the Common Tasks section below.

Log Table

The main area of the page is a table listing every log entry, with the most recent entries at the top. Each row shows:

Column What It Shows
ID A unique number for the log entry
Date/Time When the event happened
Provider Which payment provider was involved
Type Whether the entry is a Debug, Info, or Error message
Message A short summary of what happened
Details Additional information (hover over this column to see the full content)

Rows are color-coded so you can quickly spot issues:

  • Red background -- Error entries that may need your attention
  • Gray background -- Debug entries with technical background details
  • White background -- Normal informational entries

 

Note: If a message in the Details column looks cut off, hover your mouse over it. The full content will expand so you can read it without leaving the page.

 

Action Buttons

At the bottom of the page, you will find quick-access buttons to jump to related pages.

Common Tasks

How to View Recent Logs

  1. Go to Admin Panel > Billing > Logs.
  2. The page automatically shows the most recent entries first.
  3. Scroll through the table to review activity.
  4. Hover over the Details column on any row to see the full details of that entry.

How to Filter by Payment Provider

Use this when you want to see activity from just one payment provider (for example, only PayPal or only Stripe).

  1. Select the provider from the Payment Provider dropdown.
  2. Click Apply Filters.
  3. The table and statistics cards update to show only entries from that provider.

 

Tip: This is especially useful when you are troubleshooting a problem with a specific payment provider.

 

How to Filter by Message Type

Use this to focus on a specific kind of log entry.

  1. Select a type from the Message Type dropdown:
  • Debug -- Background technical details
  • Info -- Normal events like successful payments
  • Error -- Problems that need attention
  1. Click Apply Filters.

 

Tip: To quickly check for problems, set the Message Type to Error and review what comes up.

 

How to Filter by Date Range

Use this to look at logs from a specific time period.

  1. Click the Date From field and pick a start date.
  2. Click the Date To field and pick an end date.
  3. Click Apply Filters.
  4. The table shows only entries from within that date range (both dates are fully included).

How to Search Logs

Use this when you are looking for something specific, like a particular keyword or reference number.

  1. Type your search term into the Search Messages field.
  2. Click Apply Filters.
  3. The results show entries where your search term appears in either the message or the details.

Helpful search terms to try:

Search For To Find
webhook Payment notification deliveries
failed Operations that did not complete
subscription Subscription-related events
amount Entries mentioning payment amounts

How to Combine Multiple Filters

You can use all filters at the same time for a very targeted search.

  1. Select a Payment Provider.
  2. Select a Message Type.
  3. Set a Date From and Date To range.
  4. Type a keyword in Search Messages.
  5. Click Apply Filters.

Only entries matching all of your criteria will appear, and the statistics cards will update to match.

How to Clear All Filters

  1. Click the Reset button next to the Apply Filters button.
  2. The page reloads showing all log entries with no filters applied.

Navigating Between Pages

The log table shows 100 entries per page. If you have more entries than that, use the page navigation below the table to move between pages. You will see Previous and Next arrows along with page numbers. A line below the navigation tells you which page you are on and how many entries exist in total.

 

Note: Your filters stay active as you move between pages. You do not need to re-apply them.

 

At the bottom of the page, three buttons let you jump to related areas:

Button Where It Takes You
Manage Providers The page where you configure your payment providers
Manage Packages The page where you set up subscription and access packages
View Transactions The page showing individual payment transactions

Tips for New Users

 

Tip:
  • Check your billing logs at least once a day, especially when you first set up a new payment provider.
  • A sudden spike in error messages usually means something changed with your payment provider -- check your provider settings.
  • Use the date range filter to compare activity week over week and spot unusual patterns.
  • If you see a provider name showing as a number instead of a name, it means that provider was removed from your settings but its old logs still exist. This is normal and nothing to worry about.

 

Monitoring Your Payment Health

Here is a simple schedule to keep your payments running smoothly:

How Often What to Check
Daily Look at the error count -- are there any new errors in the last 24 hours?
Daily Glance at overall log volume -- is your site recording payments as expected?
Weekly Compare this week's error rate to last week -- is it going up or down?
Monthly Review each payment provider's activity to make sure they are all working

Understanding Error Rates

Error Rate What It Means What to Do
Less than 1% Everything is healthy Continue normal monitoring
1% to 5% Minor issues may exist Look at the top errors and see if there is a pattern
5% to 10% Something needs attention Review errors immediately and check your provider settings
More than 10% Serious problem Stop and investigate before it affects your revenue
Warning: If your error rate suddenly jumps above 10%, check your payment provider settings right away. Common causes include expired credentials, changed webhook addresses, or provider outages.

Recognizing Common Log Patterns

A Successful Payment Looks Like This

You will see a series of Info messages in order:

  1. A notification received from the payment provider
  2. The notification verified successfully
  3. A transaction created for the user
  4. The subscription or access updated

 

 

Success: When you see this pattern, your payment system is working correctly.

 

A Failed Payment Looks Like This

You will see one or more Error messages, often with an Info message before or after:

  1. A notification received from the payment provider
  2. An error indicating what went wrong (such as "payment declined" or "verification failed")

 

What to Do When You See Errors

  1. Filter by Message Type: Error to see all recent errors.
  2. Look for patterns -- are the errors all from the same provider? The same type of message?
  3. Hover over the Details column for more information about each error.
  4. Take action based on what you find:
Error Pattern What to Do
"Invalid API key" or "signature failed" Go to your payment provider settings and verify your credentials are correct
"Payment declined" This is normal -- it means a customer's payment method was rejected by their bank
"Connection timeout" This is usually temporary. If it keeps happening, your server may have a connectivity issue -- contact your hosting provider
"User not found" A payment came in for a user account that does not exist. Check if the customer's account was deleted

Troubleshooting

No log entries are showing up

What you see: The page loads but the table is empty and all statistics show zero.

How to fix it:

  1. Make sure you have at least one payment provider set up. Go to Admin Panel > Billing > Payment Providers and check.
  2. If you just set up your payment providers, logs will only appear after real payment activity occurs (a test transaction, a webhook from your provider, etc.).
  3. Check that your filters are not too restrictive. Click Reset to clear all filters and see if entries appear.

 

The Details column does not expand when I hover over it

What you see: You hover over a truncated entry in the Details column but it does not expand.

How to fix it:

  1. Try refreshing the page.
  2. Try a different web browser to see if the issue persists.
  3. If the entry shows "No additional details," there is nothing more to see for that entry -- it simply does not have extra detail information.

 

A payment provider shows as a number instead of a name

What you see: In the Provider column, you see a number (like "3") instead of a provider name.

How to fix it:
This happens when a payment provider was removed from your settings but its log entries still exist. The logs are still valid -- the system just cannot look up the provider's name anymore. This does not affect your site's operation.

Filters do not seem to be working

What you see: You apply filters but the results do not seem correct.

How to fix it:

  1. Click Reset to clear all filters.
  2. Apply just one filter at a time to narrow down which filter might be causing confusion.
  3. Double-check your date range -- make sure the Date From is before the Date To.

 

Page When to Use It
Payment Providers To set up or change your payment processor settings (credentials, webhook addresses, etc.)
Billing Transactions To see individual payment transactions, refunds, and subscription charges
Access Packages To create or edit the subscription plans and one-time purchase options available on your site

Related Pages