Gateway Activity Logs

View and troubleshoot API communication between Chargebee and your payment gateways.

Gateway Activity Logs provide detailed visibility into API interactions between Chargebee and integrated payment gateways. You can use this feature to view, search, and troubleshoot gateway requests and responses directly from Chargebee Billing.

Overview

When Chargebee processes payments, refunds, or other gateway operations, it communicates with payment gateways through API calls. Gateway Activity Logs capture these interactions, including:

• Request headers and body
• Response headers and body
• Status codes and timing information
• Related transaction and customer context

This visibility helps you:

• Debug payment failures
• Understand gateway behavior
• Audit payment processing
• Troubleshoot integration issues

Gateway Activity Index Page

To view all gateway logs across your Chargebee Billing site, go to Logs > Gateway Activity in the left navigation pane.

List View Columns

Select any row to view detailed information about that API call.

Filtering and Searching

Use the search bar for full-text search across logs, or apply filters to narrow the results.

Filters

You can filter gateway activity logs using the following criteria:

• Operation Type: Profile, Payment Method, Payment, Refund, Authorize, Void, Capture
• Trace ID: Groups related API calls in the same operation
• Status Code: HTTP response status
• Gateway: Payment gateway
• Source: Admin UI, API, Scheduled Job, Hosted Page, Self-Serve Portal, Gateway Webhook, etc.
• Source Action: Chargebee API or Job name
• HTTP Method: GET, POST, PUT, DELETE, PATCH
• URL: Gateway API endpoint
• Invocation Time: Date range (between, before, after)
• Payment Method: Card, Direct Debit, PayPal, Apple Pay, Google Pay, UPI, etc.
• **Customer ID, Transaction ID, Invoice ID, Payment Intent ID, Payment Attempt ID, Payment Method ID, Gateway Account
• ID: Filter by related resource IDs

Gateway Activity details page

The Gateway Activity Details page provides comprehensive information about a single gateway API call.

Request Information

The following fields are displayed at the top of the details page:

• URL: Complete gateway API endpoint URL
• Method: HTTP method used (GET, POST, PUT, DELETE)
• Status: HTTP response status code
• Invocation Time: Exact timestamp of the API call
• Duration: Time taken for the API call to complete (in milliseconds)
• Trace ID: Groups all API requests made during the same operation (e.g., Payment, Refund)
• Source: Origin of the request (e.g., API, Hosted Pages)
• Source Action: Name of the Chargebee API or Job that initiated this API call
• Operation: Type of operation (e.g., Payment, Refund, Capture)
• Gateway: Payment gateway name
• Payment Method: Payment method used (e.g., Card, ACH)

Request and Response Data

The following sections display the complete request and response data exchanged with the gateway:

• Request Headers: All HTTP headers sent to the gateway. Sensitive headers like authorization tokens are never stored.
• Request Body: The complete JSON request body sent to the gateway. Raw payment method information and sensitive secrets (such as card numbers, CVVs, or API keys) are masked before being stored and are never visible in the logs.
• Response Headers: HTTP headers returned by the gateway in the response.
• Response Body: The complete JSON response from the gateway, including transaction status, gateway-specific response codes, and error messages. Sensitive information is never stored—values shown as *** were stored that way.

Related Resources

When available, the right sidebar displays links to related resources such as transactions, payment intents, and customers, along with their associated logs.

View logs from Transactions and Payment Intents

View Gateway Activity Logs directly from Transactions and Payment Intent details pages.

Transaction Details Page

In the Gateway section of any transaction, click View Request/Response Logs to see all gateway API calls made during that transaction.

Payment Intent Details Page

Under each Payment Attempt, click View Request/Response Logs to see gateway API calls made during that specific attempt.

Security and Data Handling

Chargebee never stores sensitive information in Gateway Activity Logs. Sensitive data such as credit card numbers, CVV codes, and authentication tokens are replaced with *** before being stored. If you see *** in the logs, that is exactly what was stored as the actual sensitive values are never persisted.

This ensures compliance with PCI-DSS and other security standards.

Frequently Asked Questions (FAQs)

1. How long are gateway activity logs retained?

Gateway activity logs are retained for 30 days.

2. Which gateways are supported?

Gateway activity logs are available for all payment gateways integrated with Chargebee.

3. Why are some values showing as ***?

Chargebee masks sensitive data before storing logs. Values shown as *** indicate masked data and do not represent actual stored credentials or payment details.

4. What does the Trace ID help with?

The Trace ID groups all API requests made as part of a single operation. Operations such as payments or refunds often involve multiple gateway API calls. Use the Trace ID to view related requests together and understand the complete execution flow.