New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Introduction


  • Overview

Transactions


  • Get Started
    • Adyen
    • Braintree
    • Cybersource
    • PayPal
    • Shopify Payments
    • Stripe
  • Understand Payment Performance
  • Alerts

Settlements


  • Get Started
    • Adyen
    • Braintree
    • Cybersource
    • PayPal
    • Shopify Payments
    • Stripe
  • Settlements
  • Fees
  • Records

Data Security


  • Data Control
  • PII Data
  • Card Vaulting
  • Data Policies, Processes and Methods

Glossary


  • Standard Terms
  1. Reveal
  2. Settlements
  3. Get Started
  1. Reveal
  2. Settlements
  3. Get Started

New users (signing up only for Reveal): To explore Reveal, request a demo.

Existing Chargebee users: Contact your Account Manager to get access to Reveal.

Get Started with Settlements

The first step to using Settlements in Reveal is to connect your payment processors as data sources. Reveal uses a no-code dashboard, no engineering work required. Once a source is connected, Reveal imports your historical settlement and payout data and keeps it up to date, so you can trace funds from customer payment to bank deposit, reconcile settlement batches against bank entries, and analyze processing fees across providers.

This guide covers access requirements, the connection workflow, supported processors, and what you will see in the Settlements dashboard after your data starts flowing.

Who this guide is for

This guide is for finance and accounting teams who reconcile payouts, monitor cash flow, and verify processing fees across multiple payment processors and currencies. If your immediate goal is authorization performance, decline analysis, or revenue recovery, connect the same processors for Transactions and use both modules together for end-to-end visibility from authorization through payout.

Before you connect your payment processors

You need access to the Reveal dashboard and read-only credentials (or equivalent permissions) for each payment processor you plan to connect.

  • Reveal access: Request a demo if you are evaluating Reveal, or contact your Account Manager if you are an existing Chargebee customer.
  • Processor permissions: Most integrations require read-only API keys or restricted permissions in the processor's dashboard. Each processor guide below lists the exact credentials and permission scopes.
  • Gateway Account access: You must be able to log in to the processor account you want to connect. Some processors, such as Adyen, require setup at the merchant account level.

Note

Connecting a source does not change how payments are processed or paid out. Reveal reads settlement and transaction data from your processors to generate reconciliation and fee analytics, and does not modify live payment flows.

Connect a payment processor to Settlements

A source you connect can serve both modules, so if you have already connected a processor for Transactions, it can also feed Settlements. The connection workflow is the same across processors and requires no custom code:

  1. Open the Reveal dashboard and select Settlements from the toggle at the top center of the page.
  2. Click Sources in the left navigation, then click Add source.
  3. Select your payment processor and enter the connection details listed in that processor's guide.
  4. Configure read-only permissions or restricted API keys in the processor's dashboard when required.
  5. Click Connect.

After a successful connection, Reveal imports historical settlement data from that source and continues to keep it current. Initial data load time depends on settlement volume and the processor.

Supported payment processors for Settlements

Use the step-by-step guides below to connect each processor. The setup process is largely the same for Settlements and Transactions—you can connect the same processor to one or both modules.

ProcessorConnection guideAdditional setup
AdyenReport Service User API keys, webhooks, and automatic report generationContact your Account Manager for a guided onboarding call if you prefer assisted setup
BraintreeAPI keys (Public Key, Private Key, Merchant ID)Braintree read-only access
CybersourceREST API credentials and key permissionsNot applicable
PayPalREST API credentialsPayPal read-only permissions
Shopify PaymentsCustom app and Admin API access tokenShopify Payments staff account
StripePublishable key and Secret keyStripe restricted keys

Explore Settlements after connecting

Once your sources are connected, select Settlements from the top toggle to open the Reconciliation overview. This page tracks the movement of funds across your connected Gateway Accounts, from customer payment to bank deposit.

Reveal Settlements Reconciliation overview showing Authorized, Captured, and Settled KPI cards, a reconciliation trend chart, an unsettled volume aging chart, and a Gateway account summary table, with Settlements selected in the top toggle.

On the Reconciliation overview you can:

  • Review KPI cards for Authorized (volume paid by customers), Captured (volume transferred to your merchant account), and Settled (volume paid out to your bank account).
  • Track Authorized Volume against Settled volume over time in the reconciliation trend chart to see how quickly funds move to your bank account.
  • Monitor the Unsettled volume aging chart to spot funds that have not yet settled, grouped by how long they have been outstanding.
  • Review the Gateway account summary table to compare settlement performance across processors.
  • Filter by Gateway Account, transaction currency, settlement currency, and date range to focus on a specific segment of your payment flow.

Switch between Settlements and Transactions

Reveal is organized into two modules that share the same connected sources. Use the Transactions / Settlements toggle at the top center of the dashboard to switch modules without leaving Reveal.

  • Settlements focuses on reconciliation—tracking authorized, captured, and settled volume, monitoring unsettled transaction aging, reviewing provider-level summaries, and analyzing fees.
  • Transactions focuses on payment observability—authorization rates, declines, error analysis, retries, and alerts.

See Get started with Transactions for the Transactions connection workflow.

Take the next step with Settlements

After your processors are connected and data is flowing, use these areas to go deeper:

  • Settlements — Review settlement summaries by provider and settlement currency, inspect batch-level settlement details, and match amounts against bank entries.
  • Fees — Compare blended processing rates across providers and understand your cost of payment acceptance.
  • Provider-level fee insights — Break down fees by payment provider.
  • Outliers — Detect transactions with fees above expected benchmarks, such as interchange downgrades.
  • Records — Browse settled transactions by Gateway Account, filter by date, currency, type, and status, and export data for accounting workflows.

Most teams connect the same processors to both Settlements and Transactions so finance and operational views stay aligned from authorization through payout.

See also

  • Reveal overview
  • Get started with Transactions
  • Standard terms glossary

Was this article helpful?