Payout reconciliation report

Allow connected accounts to view and export payout reconciliation reports.

Note

Connected accounts that have access to the Express Dashboard can access the payout reconciliation report directly in the Express Dashboard, so you don’t need to embed it separately. Click View reports in your Express features settings to enable it.

The payout reconciliation report component allows connected accounts to view and export reports that reconcile each automatic payout with the batch of transactions it settles. It displays three subreports:

• Balance summary : Shows starting and ending Stripe balance for the selected date range, along with a high-level summary of activity during the period.
• Payout reconciliation : A breakdown of the automatic payouts received in the connected account’s bank account during the selected date range, with transactions grouped by reporting category.
• Ending balance reconciliation : A breakdown of the transactions that haven’t settled as of the report’s end date.

Connected accounts can filter the report by date range and currency. They can also export each subreport as summarised or itemised CSV downloads.

These subreports are similar to the payout reconciliation reports for direct Stripe accounts.

Component availability

If a connected account doesn’t use automatic payouts, the payout reconciliation report component renders nothing. Use the onReportAvailabilityLoaded callback to detect this state and display your own empty state or alternative UI.

If a connected account changes from automatic payouts to manual payouts, this component no longer renders their payout data. If a connected account changes from manual payouts to automatic payouts, this component only includes data for their automatic payouts.

The balance report component renders payout data for all connected accounts, regardless of their payout type.

Note

Connected accounts without access to the full Stripe Dashboard can only view data starting from April 1, 2026, unless your platform has been specifically backfilled.

When you create an Account Session, enable the payout reconciliation report by specifying payout_reconciliation_report in the components parameter.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

After creating the account session and initialising ConnectJS, you can render the payout reconciliation report component in the front end:

PayoutReconciliationReport.js

Select a language

JavaScript

React

No results

// Include this element in your HTML
const payoutReconciliationReport = stripeConnectInstance.create(
 "payout-reconciliation-report"
);
container.appendChild(payoutReconciliationReport);

// Optional: Set a callback to handle report availability.
// The payout reconciliation report is only available for accounts
// on automatic payouts. Use this callback to show your own empty
// state when the report is unavailable.
payoutReconciliationReport.setOnReportAvailabilityLoaded(
 ({ isReportAvailable }) => {
 if (!isReportAvailable) {
 // Hide the component container or show a custom message
 container.style.display = "none";
 document.getElementById("fallback-message").textContent =
 "Payout reconciliation reports are only available for accounts that " +
 "use automatic payouts.";
 }
 }
);

Accounts connected to multiple platforms

For connected accounts that aren’t controlled exclusively by your platform:

• The report includes transactions from all platforms the account is connected to.
• The connected account must complete user authentication before viewing the report.