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?