# Payouts Report

The Payouts Report provides an overview of settlement payouts within a specified time frame, along with the associated fees and activity breakdown.

It enables you to reconcile payouts with amounts that you subsequently receive in your bank account and that appear on your bank statements.
You can also use it together with the [Financial Actions by Payout ID Report](https://www.checkout.com/docs/funds-management/retrieve-financial-reports/settlement-reports/financial-actions-by-payout-id-report.md) to reconcile payouts with the associated payments and fees, using the payout ID.

The report is available per entity. There is a row for each payout from a sub-account, which lists:

- The total amount to be paid out
- The aggregated fees charged for payments processed – for example, interchange fees
- Any account-level fees charged for the payout – for example, merchant payout fees

---

## Report availability

You can generate the Payouts Report on a daily, weekly, or monthly basis. It is available between 10:00am and midday in the [settlement time zone](https://www.checkout.com/docs/funds-management/receive-settlements.md#Settlement_time_zone) you've configured for the entity.

The daily Payouts Report includes any payouts created that day in that settlement time zone.
For example, if your time zone is `America/Los_Angeles Pacific Time` (PT) and a settlement is generated on August 3 at 9:00am PT, the settlement is included in the daily Payouts Report.
The report is available at midday PT on August 3.

See instructions on how to download the report on demand or on a schedule:

- [In the Dashboard](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Generate_reports_in_the_Dashboard)
- [Using the API](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Retrieve_reports_using_the_API)
- [Using Secure File Transfer Protocol (SFTP)](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Access_reports_using_SFTP)
- [Using webhooks](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Receive_reports_using_webhooks)

---

## Report format

The report is provided as a CSV file. By default, the file name uses the following formats:

- API and SFTP – `payouts_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv`
- Dashboard scheduled reports – `payouts_{Entity ID}_{Start Date:YYYYMMDD}_{End Date:YYYYMMDD}_1.csv`

For SFTP, the report is uploaded in the following folder structure: <br>
`{Entity_name} > reports-{Entity_name} > payouts`

---

## Sample report

Download a sample [Payouts Report](https://www.checkout.com/docs/files/Sample_Payouts_Report.csv) (CSV file).

> **Information**
>
> If you're using Safari, hold the _Option_ key when you download.

---

## Report fields

> **Information**
>
> - To enable any optional fields, contact your account manager or [request support](https://dashboard.checkout.com/support/new?topic=case_account_management_and_access&issue=issue_account_changes).
>
> - Sub-accounts are referred to as currency accounts in the report fields.
>
> - All decimal amounts are expressed in the [major currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md), with fixed-point notation with up to eight decimal places.
> For example, 500 USD is represented as `500.00`.

The report can include the following fields in this order:

| Field name | Description |
| --- | --- |
| Client Entity ID<br><br>`string` | The unique identifier for the entity the payout was processed for. <br>Example – `ent_abcdef1ghijklmn23opq45r6st` |
| Client Entity Name<br><br>`string` | The name of the entity. |
| Sub Entity ID<br><br>`string` | The unique identifier for the sub-entity the payout was processed for. <br>Example – `ent_abcdef1ghijklmn23opq45r6st` |
| Sub Entity Name<br><br>`string` | The name of the sub-entity. |
| Currency Account ID<br><br>`string` | The unique identifier for the sub-account the payout will be paid from. <br>Example – `ca_abcdef1ghijklmn23opq45r6st` |
| Currency Account Name<br><br>`string` | The name of the sub-account the payout will be paid from. |
| Holding Currency<br><br>`string` | The sub-account's currency. <br>Format – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) <br> Example – `USD` |
| Payout ID<br><br>`string` | The unique identifier for the payout. <br>Example – `000ABC1DE23F` <br><br><br>For settlement payouts, this is the same value as the settlement ID. |
| Payout Date<br><br>`date-time` | The date and time when the payout was made, in your settlement time zone. <br>Format – ISO 8601 code <br>Example – `2025-01-31T10:20:30.456` |
| Reporting Start Date<br><br>`date-time` | The start date and time of the reporting period, in your settlement time zone.<br><br>The first time a payout is made from a sub-account's _Available_ balance, this field displays the date and time when the sub-account was created.<br><br>For all subsequent payouts, this is the start date and time of the reporting period.<br><br>Format – ISO 8601 code <br>Example – `2025-01-31T10:20:30.456` |
| Reporting End Date<br><br>`date-time` | The end date of the reporting period, in your settlement time zone. <br>Format – ISO 8601 code <br>Example – `2025-01-31T10:20:30.456` |
| Payout Amount<br><br>`decimal` | The total amount of the payout. |
| Merchant Payout Fees<br><br>`decimal` | The total fees charged by Checkout.com for settlement payouts. |
| Payments<br><br>`decimal` | The total gross amount of your payments processed. |
| Refunds<br><br>`decimal` | The total gross amount of full and partial refunds processed. |
| Chargebacks<br><br>`decimal` | The total net amount of chargeback transactions processed. |
| Pay To Cards<br><br>`decimal` | The total amount of funds paid out for Card Payouts. |
| Card Payment Interchange Fees<br><br>`decimal` | The total interchange fees charged by issuers for card payments. |
| Card Payment Scheme Fees<br><br>`decimal` | The total amount of fees charged by card schemes for card payments. |
| Acquiring Premiums<br><br>`decimal` | The total amount of Checkout.com Premium fees charged for each successful card payment captured. |
| Card Payment Gateway Fees<br><br>`decimal` | The total gateway fees charged by Checkout.com for card payments when payment actions occur. <br><br>Example – Authorizations, verifications, voids |
| Card Payment Blended Fees<br><br>`decimal` | The total agreed card-payment blended fees charged by card schemes for captured payments, if applicable. |
| Refunded Interchange Fees<br><br>`decimal` | The total interchange fees charged by issuers that were refunded to you. |
| Refund Scheme Fees<br><br>`decimal` | The total fees charged by card schemes for refunds. |
| Refund Gateway Fees<br><br>`decimal` | The total gateway fees charged by Checkout.com for refund actions. |
| Chargeback Fees<br><br>`decimal` | The total fees charged by Checkout.com for processing chargebacks as part of the disputes process. |
| Retrieval Fees<br><br>`decimal` | The total fees charged by Checkout.com for retrieval actions as part of the disputes process. |
| Representment Fees<br><br>`decimal` | The total fees charged by Checkout.com for representment actions as part of the disputes process. |
| Pay To Card Interchange Fees<br><br>`decimal` | The total interchange fees charged by issuers for processing Card Payouts. |
| Pay To Card Scheme Fees<br><br>`decimal` | The total fees charged by card schemes for processing Card Payouts. |
| Pay To Card Fees<br><br>`decimal` | The total fees charged by Checkout.com for Card Payouts. |
| Alternative Payment Method Fees<br><br>`decimal` | The total fees charged by Checkout.com for accepting alternative payment methods (APMs). |
| Adjustments<br><br>`decimal` | The total amount of adjustments charged by Checkout.com to the sub-account. |
| Tax<br><br>`decimal` | The total local value-added tax charged on your fees, if applicable. |
| Account Updater Fees<br><br>`decimal` | The total fees charged by Checkout.com for the [Real-Time Account Updater](https://www.checkout.com/docs/payments/store-and-manage-credentials/update-stored-credentials.md) service. |
| Transfers In<br><br>`decimal` | The total amount of transfers into the sub-account. |
| Transfers Out<br><br>`decimal` | The total amount of transfers out of the sub-account. |
| Integrated Platforms Fees<br><br>`decimal`<br>`optional` | The fees charged by Checkout.com for onboarding and managing your sub-entities. |
| Reserve Deducted<br><br>`decimal`<br>`optional` | The total reserves deducted from your processing and held by Checkout.com for the agreed reserve period. |
| Reserve Released<br><br>`decimal`<br>`optional` | The total reserves Checkout.com released to you after the agreed reserve period passed. |
| Billing Fees<br><br>`decimal`<br>`optional` | The total fees charged by Checkout.com for billing agreements. <br><br>Example – Minimum billing |
| Authentication Fees<br><br>`decimal` | The total fees charged by Checkout.com for processing authentications. |
| Authentication Scheme Fees<br><br>`decimal` | The total fees charged by card schemes for processing authentications. |
| Risk Engine Fees<br><br>`decimal`<br>`optional` | The total fees charged by Checkout.com for transactions screened by [Fraud Detection Pro](https://www.checkout.com/docs/business-operations/prevent-fraud/understand-fraud-detection.md). |
| Pay to Bank Fees<br><br>`decimal`<br>`optional` | The total fees charged by Checkout.com for processing Bank Payouts, including returned Bank Payout fees. |
| Pay to Bank payouts<br><br>`decimal`<br>`optional` | The total amount paid out for Bank Payouts. |
| Intelligent Acceptance Fees<br><br>`decimal`<br>`optional` | The total fees charged by Checkout.com for transactions optimized by [Intelligent Acceptance](https://www.checkout.com/docs/payments/optimize-payments/intelligent-acceptance.md). |
| Network Token Fees<br><br>`decimal`<br>`optional` | The total fees charged by Checkout.com for the [Network Tokens](https://www.checkout.com/docs/payments/store-and-manage-credentials/store-credentials/network-tokens.md) service. |
| Timezone<br><br>`string`<br>`optional` | Your settlement time zone. <br><br>Example – `America/Los_Angeles` |
| Vault Fees<br><br>`decimal`<br>`optional` | The total fees Checkout.com charged for [storing credentials](https://www.checkout.com/docs/payments/store-and-manage-credentials/store-credentials.md). |
| Acceleration Fees<br><br>`decimal`<br>`optional` | The total fees Checkout.com charged for [accelerated settlements](https://www.checkout.com/docs/funds-management/access-funds/acceleration.md). |
| Payout Status<br><br>`string`<br>`optional` | The status of the payout. This can be one of:<br><br>- `Instructed`<br>- `Carried forward`<br><br>**Information**: This field is only available if you've enabled the `Carried forward` settlement status. |
| Balance Carried Forward<br><br>`decimal`<br>`optional` | The amount carried forward if the previous settlement value was negative, zero, or below your payout threshold.<br><br>**Information**: This field is only available if you've enabled the `Carried forward` settlement status. |
| Balance Minimum Adjustment<br><br>`decimal`<br>`optional` | The amount added to or deducted from your settlement to maintain your configured [balance minimum](https://www.checkout.com/docs/funds-management/manage-funds/balances/manage-balances.md#Set_a_balance_minimum_). This value can be either positive or negative.<br><br>**Information**: This field is only available if you have a balance minimum set on your settlement schedule. |