Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Transactions Overview

Transactions in Chargebee represent the movement of money between your business and your customers. They provide a clear audit trail for billing, payments, refunds, and adjustments.
A transaction is created whenever money is charged, refunded, or adjusted in your Chargebee account.

This includes all transactions that happen through Chargebee Embedded Payments. Transaction details in Chargebee consist of the following sections:

  • Summary – High-level details of the transaction.
  • Payment Details – Information about payment status and processing.
    • Overview – Context of the transaction, including linked invoices and customers.
    • Deductions – Any deductions, such as gateway fees or adjustments.
    • Payment Instrument – The payment method used (e.g., card, bank account).
  • Refund Details – Information about refunds processed against the transaction.

Summary

The Summary page provides an overview of transactions, grouped into the following categories:

  • All Transactions
  • Successful
  • Failed
  • Refunds

All Transactions

This tab displays all transactions processed through Chargebee Embedded Payments. The list is sorted by Transaction Date by default.

  • Filters: The default setting for the Transaction Period defaults to Month to Date, while other filters will not have any pre-selected values.
  • Search: Transactions can be searched using the Transaction ID.
  • Data Table: The data table supports infinite scrolling and loads 20 records per iteration.
  • Export: Transactions can be exported in CSV format. If filters are applied, only the filtered records will be downloaded.

Note:

The data table functions the same as shown in All Transactions, but only includes successful transactions.

Successful Transactions

This includes all approved transactions processed by Chargebee Embedded Payments.

  • Filters: The filters function is similar to the one in All Transactions view, except for the Status filter, which is fixed as Success and cannot be modified.
  • Search: The search function operates the same as the one in the All Transactions view.
  • Data Table: The data table will only include successfully processed transactions.

Failed Transactions

This includes all failed transactions processed through Chargebee Embedded Payments.

  • Filters: The filters function as demonstrated in the All Transactions view, with the exception that the Status filter will be disabled and cannot be modified.
  • Search: The search function operates identically as shown in the All Transactions view.
  • Data Table: The data table will only include failed transactions.

Refunds

This includes all transactions processed through Chargebee Embedded Payments that have been refunded.

  • Filters: The filters function as demonstrated in the All Transactions view, except for the Type filter, which will be disabled and cannot be modified.
  • Search: The search function operates the same as the one in the All Transactions view.
  • Data Table: The data table will only include the refunded transactions.

Payment Details

A payment is a financial transaction in which an amount is deducted from the customer’s bank account. To view payment details, click any row in the Transactions table. The payment details section consists of the following sub-sections:

  • High-Level Details
  • Overview
  • Payment
  • Refunds
  • Audit Logs

High-Level Details

This section includes high-level payment transaction details that are critical for your transaction. It comprises the following details.

FieldDescription
Transaction Type

Payment in this example. Possible values as per UI:

  • Payment
  • Refund
  • Payment Return
  • Payment Reversal
  • Credit
  • Debit
  • Reserve
Transaction AmountDisplayed in USD in this example
Status
  • Success: When the transaction is successful.
  • Failed: When the transaction has failed. The declined reason is displayed at the top.
  • Cancelled: Transaction was cancelled.
  • Pending: This mostly happens with ACH payments, which take 2–3 days to complete.
  • Returned: A late payment failure for direct debit (ACH, SEPA, BACS) after payout due to reasons like insufficient funds, account closed, etc.
Transaction IDDisplays the unique ID of the transaction.
CustomerDisplays the name of the customer.

Overview

This section gives you an overview of payment transaction details and comprises the following fields:

FieldDescription
Transaction DateDisplays the date and time of the transaction.
Settlement DateDisplays the date and time of the settlement.
Settlement IDDisplays the deposit ID / settlement ID for settled transactions.
Dispute IDDisplays the dispute ID if a chargeback is initiated.
AmountDisplays the transaction amount.
DeductionsIncludes transaction processing fees and reserve deduction, if any.
Net AmountNet amount = Amount - Deductions

Payment Instrument

This section gives you the details of the payment method used for the transaction. This can be one of the following:

  • Cards
  • ACH
  • SEPA
  • BACS
Payment TypeFieldDescription
Card PaymentCard SchemeVisa, Mastercard, and other supported card networks.
Card TypeDebit / Credit / Prepaid
Card NumberLast 4 digits of the card
Expiry DateCard expiration date
Postal/Zip CodeBilling address zip code
Payment Instrument IDUnique identifier for the card on file
Cardholder NameName on the card
AVS CheckValues: Passed, Failed
CVC CheckValues: Passed, Failed
ACH DebitPayment Instrument IDUnique identifier for the bank account on file
Bank AccountDisplays only the last 3 digits of the bank account number
Account Holder NameName associated with the bank account

Refunds

This section lists all refunds issued against the selected transaction. You can also initiate refunds from here. The sum of all refunds created should not be greater than the transaction amount.

Refund Details

A refund is the process of returning money to a customer who paid for a product, service, or transaction. This section explains the features and interactions in the refund details view. Chargebee payments supports full and partial refunds.

The refund details consist of the following sections:

  • High-Level Details
  • Overview

High-Level Details

This section includes high-level payment refund details that are critical for your transaction. It comprises the following fields.

FieldsDescription
Transaction Type

Refund in this example Possible values (as displayed in the UI) are:

  • Payment
  • Refund
  • Payment Return
  • Payment Reversal
  • Credit
  • Debit
  • Reserve
Transaction AmountDisplayed in USD
Status
  1. Success: The refund was processed successfully.
  2. Failed: The refund failed. The decline reason is displayed at the top.
Transaction IDUnique identifier for the refund transaction
CustomerName of the customer

Overview

This section provides an overview of the refund transaction, including:

FieldDescription
Transaction DateDate the refund was initiated
Refund AmountAmount refunded. This value is less than or equal to the original transaction amount.
FeeNot applicable. Always 0.
Parent TransactionLink to the original transaction

Was this article helpful?