Payout reconciliation report

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 accounts bank account during the selected date range, with transactions grouped by reporting category.
• Ending balance reconciliation: A breakdown of the transactions that havent settled as of the reports end date.

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

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

Component availability

If a connected account doesnt 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.

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

curl https://api.stripe.com/v1/account_sessions \
  -u "sk_test_wU7nrJCZspk1NPDxiQgAF05q:" \
  -d "account=
{{CONNECTED_ACCOUNT_ID}}" \
  -d "components[payout_reconciliation_report][enabled]=true"

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

// 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 arent 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.