Skip to content

Last updated: February 22, 2023

Financial actions reports provide an accurate representation of all actions during a payment’s life-cycle that impact your currency account's available balance. Together with the payouts reports, you can reconcile payments and any associated fees against payouts paid out to you.

Understanding the financial impact of each action and any foreign exchange (FX) rates applied also allows you to accurately assess your cost of sale.

Understanding your financial actions reports

The reports come in two forms:

  • Financial actions by date range: contains financial actions across a specified time period.

  • Financial actions by payout ID: contains financial actions related to a specific payout ID—useful when reconciling financial actions with a payout paid out to your bank account.

Every row features a unique financial action ID that can be linked to a specific payment, using the payment ID, or a settled payout, using the payout ID.

Both reports feature identical field names and list records chronologically.

Report format

Financial actions reports come in CSV format with the file name following these templates:

  • Financial actions by date range:

financial-actions_{Your Entity-ID}_{Start Date Range:YYYYMMDD}_{End Date Range:YYYYMMDD}_1.csv

  • Financial actions by payout ID:

financial-actions_{Your Entity-ID}_{Payout date: YYYYMMDD}_{PayoutID}_1.csv

When are my reports available?

The availability of your reports depends on the type of financial action report available to you.

Financial actions by date range

These reports are made available by 12:00:00 UTC and include any financial actions that impacted your available balance between 00:00:00 UTC and 23:59:59 UTC the previous day.

For example, all financial actions that occur on August 3, 2020 (from 00:00:00 UTC to 23:59:59 UTC) will be included in the daily financial actions by date range report generated and available from August 4, 2020 at 12:00:00 UTC.

Financial actions by date range can be made available on a daily, weekly or monthly basis.

Financial actions by payout ID

These reports are made available by 15:00:00 UTC. The data includes any financial actions that have impacted your available balance and are linked to any settlements created between 12:00:00 UTC the previous day and 12:00:00 UTC on the same working day.

For example, for a settlement created on August 3, 2020 at 07:00:00 UTC, any financial actions associated to the settlement will be included in the financial actions by payout ID report available on August 3, 2020 at 15:00:00 UTC.

Report fields

Sample reports

Select the following links to download sample reports:


If you're using Safari, hold the Option key when you download.