> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptoprocessing.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Payments report

**Available to all roles (Roles determine what each user can see and do in the portal.) except**

You can export the history of payments on your balances for a selected period.

**Step 1**

In your portal, go to the **Payments** tab.

**Step 2**

Click **Filters** and specify the date range and other filters.

**Step 3**

Click **Export** to generate the report with the payments.

The report can take from a few seconds to a few minutes to generate. If it's done within a few seconds, it will be downloaded immediately. If it takes longer, you can find and download it later within 30 days using the **Reports** icon in the left panel.

The report is a CSV file showing the *operations* and *payments* that match the filters.

* An **operation** typically matches 1:1 to an **entry** (as seen in the [Transactions report](https://docs.cryptoprocessing.us/reporting/transactions-report.md)), with one exception: if an entry involves two currencies, it will be split into two operations. Each operation always works with a single currency, but it may take multiple rows. Its type is [OPERATION\_TYPE](#param-operation-type), and its unique identifier is [OPERATION\_ID](#param-operation-id).

* A **payment** represents a single change of the balance in a single currency. Each payment takes exactly one row, and it is the smallest unit in the CryptoProcessing reporting. Its type is [TYPE](#param-type), and its unique identifier is [PAYMENT\_ID](#param-payment-id).

## Operation and payment types

**OPERATION\_TYPE** `enum`

The type of the operation to which the payment belongs.

Possible values:

* `deposit` — a [deposit](https://docs.cryptoprocessing.us/deposits.md).
* `withdrawal` — a [withdrawal](https://docs.cryptoprocessing.us/withdrawals.md).
* `trade` — an [exchange](https://docs.cryptoprocessing.us/exchanges.md).
* `top_up` — a [fiat top-up](https://docs.cryptoprocessing.us/fiat/top-up-fiat.md).
* `transfer` — the network fee for transferring funds between a deposit address and a master address.
* `cashout` — an [automatic withdrawal to a cold address](https://docs.cryptoprocessing.us/merchant-administration/configure-automatic-withdrawals-to-cold-addresses.md).

**TYPE** `enum`

The type of the payment.

Possible values:

* [Deposits](https://docs.cryptoprocessing.us/deposits.md): `deposit`, `deposit_rollback`.
* [Withdrawals](https://docs.cryptoprocessing.us/withdrawals.md): `withdrawal`, `withdrawal_rollback`.
* [Fiat operations](https://docs.cryptoprocessing.us/fiat/top-up-fiat.md): `top_up`.
* Fees: `fee_*` or `*_fee` (for example, `fee_crypto_deposit` or `mining_fee`). See the fees for [deposits](https://docs.cryptoprocessing.us/deposits/fees.md), [payment requests](https://docs.cryptoprocessing.us/payment-requests/fees.md), [withdrawals](https://docs.cryptoprocessing.us/withdrawals/fees.md), and [exchanges](https://docs.cryptoprocessing.us/exchanges/fees.md).

## Payment identifiers

**TRANSACTION\_ID** `integer`

The identifier of the corresponding transaction from the [Transactions report](https://docs.cryptoprocessing.us/reporting/transactions-report.md). It is identical for all payments in the same transaction.

**TRANSACTION\_ENTRY\_ID** `integer`

The identifier of the corresponding entry from the [Transactions report](https://docs.cryptoprocessing.us/reporting/transactions-report.md).

**OPERATION\_ID** `integer`

The unique identifier of the operation to which the payment belongs. It is identical for all payments in the same operation.

**PAYMENT\_ID** `integer`

The unique identifier of the payment (one row in the file).

**PAYMENT\_REQUEST\_ID** `string | null`

The identifier of the [payment request](https://docs.cryptoprocessing.us/payment-requests.md). Empty if the payment isn't related to a payment request.

## Amounts and currencies

**AMOUNT** `number`

The amount of the payment. The value is always unsigned, regardless of the payment type. For the `deposit`, `top_up` and `withdrawal_rollback` types, the amount is added to the balance. For all other types, it is subtracted from the balance.

**CURRENCY** `string`

The currency of `AMOUNT`. See [Currency codes](https://docs.cryptoprocessing.us/api-reference/currency-codes.md).

**BALANCE** `number`

The merchant's balance in `CURRENCY` after the payment.

## Custom data

**FOREIGN\_ID** `string | null`

Custom identifier that was provided as `foreign_id` when creating the deposit address, initiating the withdrawal, or creating the payment request via the API.

**NOTE** `string | null`

An optional note that the CryptoProcessing team adds to explain a payment created manually, for example, a balance correction.

## Dates

**CREATED\_AT** `YYYY-MM-DD HH:MM:SS`

The date and time of the transaction.

**CONFIRMED\_AT** `YYYY-MM-DD HH:MM:SS`

The date and time of the payment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.