# Bank Payouts Report The Bank Payouts Report lists all pending, successful, rejected, and declined bank payouts within a specified time frame. It includes: - The name, ID, and country of the payout sender (if not your entity) and of the recipient - The payout date, ID, type, any reference, amount, and currency - The payout recipient's account details - Information about any funds the recipient's bank returned to you --- ## Report availability The report data is refreshed approximately every two hours. 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_via_API) - [Using Secure File Transfer Protocol](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Access_reports_via_SFTP) (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. The file name uses the following formats by default: - API and SFTP – `paytobank_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv` - Dashboard scheduled reports – `{Start date:YYYYMMDD}-{End date:YYYYMMDD}-Bank Payouts Report-{Entity name}.csv` For SFTP, the report is uploaded in the following folder structure:
`{Entity_name} > reports-{Entity_name} > paytobank` --- ## Sample report [Download a sample report](https://www.checkout.com/docs/files/Sample_Bank_Payouts_Report.csv) (CSV file). > **Information** > > If using Safari, hold down the _Option_ key when selecting the link to download the file. --- ## Report fields The report includes all of the following fields in this order: | Field name | Description | | --- | --- | | Action ID

`string` | The bank payout's unique identifier, prefixed with `act_`. | | Action Date UTC

`date-time` | The date and time when you performed the bank payout, in UTC.
Standard – ISO 8601
Example – `YYYY-MM-DDThh:mm:ss.sss` | | Client Name

`string` | Your name as a Checkout.com client. | | Entity Name

`string` | The name of your Checkout.com entity. | | Entity ID

`string` | The entity's unique identifier, prefixed with `ent_`. | | Sub Entity ID

`string` | For [Platforms bank payouts](https://www.checkout.com/docs/platforms/process-sub-entity-payouts/process-bank-payouts.md), the sub-entity's unique identifier, prefixed with `ent_`. | | Sub Entity Name

`string` | For Platforms bank payouts, the sub-entity's name. | | Payout Date

`date-time` | The date and time when you sent the payout, in UTC.
Standard – ISO 8601
Example – `YYYY-MM-DDThh:mm:ss.sss` | | Value Date

`date-time` | The date and time when the funds were settled with the recipient, in UTC.
Standard – ISO 8601
Example – `YYYY-MM-DDThh:mm:ss.sss` | | Payment ID

`decimal` | The payout payment's unique identifier, prefixed with `pay_`. | | Action Type

`string` | The payout status. This can be one of:

- `PayoutCreated` – You've created the payout.
- `PayoutConfirmed` – The payout is settled with the recipient.
- `PayoutRejected` – The payout was rejected.
- `PayoutReturned` – The recipient's bank returned the funds. | | Recipient Reference

`string` | The recipient's reference for the payout. | | Sender Reference

`string` | The sender's reference for the payout. | | Destination Amount

`decimal` | The amount of the payout in the recipient's account.

Format – Fixed-point notation with up to eight decimal places

Example – 500 USD is represented as `500.00`

For how to calculate currency units, see [Format the amount value](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). | | Destination Currency

`string` | The currency in which the payout appeared in the recipient's account.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) | | Source Amount

`decimal` | The amount of the payout in the sender's account.

Format – Fixed-point notation with up to eight decimal places

Example – Write 500 USD as `500.00`.

For how to calculate currency units, see [Format the amount value](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). | | Source Currency

`string` | The currency in which the payout appears in the sender's account.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Originator Country

`string` | The country the payout was sent from.
Standard – [ISO alpha-2 country code](https://www.checkout.com/docs/developer-resources/testing/codes/country-codes.md)
Example – `US` | | Destination Country

`string` | The country the payout was sent to.
Standard – [ISO alpha-2 country code](https://www.checkout.com/docs/developer-resources/testing/codes/country-codes.md)
Example – `US` | | Recipient Name

`string` | The name of the recipient. | | Account Number / IBAN

`string` | The recipient's account number or International Bank Account Number (IBAN).
For the required format in different countries, see [Bank account field formatting](https://www.checkout.com/docs/payments/request-payouts/bank-payouts/bank-account-field-formatting.md). | | Bank Code / SWIFT

`string` | The unique identifier for the recipient's bank.
For the required format in different countries, see [Bank account field formatting](https://www.checkout.com/docs/payments/request-payouts/bank-payouts/bank-account-field-formatting.md). | | Billing Descriptor

`string` | The [billing descriptor](https://www.checkout.com/docs/payments/manage-payments/manage-billing-descriptors.md) you provided with the payout, which is displayed on the recipient's bank statement if supported by their bank. | | Return Amount

`decimal` | The amount the recipient's bank returned to you due to an error, in the [major currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md).

Format – Fixed-point notation with up to eight decimal places

Example – Write 500 USD as `500.00`. | | Return Currency

`string` | The currency in which the payout was returned.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Return Reason

`string` | The [API response code](https://www.checkout.com/docs/developer-resources/codes/api-response-codes.md#50xxx_Card_payout_declines) that provides information about why the payout was returned.
Example – `50499` |