# Categorias e tipos de relatórios

Entenda as categorias dos objetos BalanceTransaction e suas distinções.

Saiba mais sobre o campo `reporting_category` nos objetos `BalanceTransaction` e como ele difere de `type` e de outras categorizações.

## O campo de categoria de relatório

O campo `reporting_category` do objeto `BalanceTransaction` melhora o campo `type` ao fornecer um agrupamento mais útil para a maioria das finalidades financeiras e de geração de relatórios. As seções a seguir descrevem as vantagens do campo `reporting-category`.

##### Uma análise mais detalhada de type=adjustment

O atributo `reporting_category` separa as transações de saldo com `type=adjustment` em várias categorias diferentes, incluindo contestações, anulação de contestações e reembolsos com falha. Além disso, categoriza vários tipos de tarifas e reembolsos de tarifas da plataforma *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) com `reporting_category=fee`.

#### Uma categoria separada de anulações de captura parcial

Se você estiver [autorizando e capturando separadamente](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md) os pagamentos e capturar um valor menor do que a autorização inicial, verá duas transações de saldo: uma para o valor total da autorização e outra anulando a parte não capturada. (A soma das duas transações de saldo produz a parte capturada da cobrança).

A transação de saldo que anula a parte não capturada tem `type=refund`, assim como se você tivesse reembolsado uma parte de uma venda em um momento posterior. Para permitir o tratamento separado desses dois objetos — talvez compensando-os no valor da venda inicial, em vez de como um reembolso separado — eles são rotulados com a categoria distinta de relatórios `partial_capture_reversal`.

#### Consolide vários tipos em categorias comuns

Com o campo `type`, as transações de saldo resultantes de cobranças no cartão são representadas com `type=charge`, enquanto aquelas feitas com [outras formas de pagamento](https://docs.stripe.com/payments/payment-methods/overview.md) são representadas com `type=payment`. Reembolsos e falhas de cartões também são separados dos de outras formas de pagamento, com os tipos `refund` e `payment_refund`, respectivamente.

O atributo `reporting_category` simplifica esses (e outros) grupos de tipos, como segue:

| Tipos de transação de saldo                                                                      | Categoria de relatório |
| ------------------------------------------------------------------------------------------------ | ---------------------- |
| `charge`, `payment`                                                                              | `charge`               |
| `refund`, `payment_refund`                                                                       | `refund`               |
| `payout_cancel`, `payout_failure`                                                                | `payout_reversal`      |
| `transfer`, `recipient_transfer`                                                                 | `transfer`             |
| `transfer_cancel`, `transfer_failure`, `recipient_transfer_cancel`, `recipient_transfer_failure` | `transfer_reversal`    |

##### Nomes de categorias mais descritivos

Renomeamos vários tipos de transações de saldo para mais clareza:

| Tipo de transação de saldo | Categoria de relatório    |
| -------------------------- | ------------------------- |
| `application_fee`          | `platform_earning`        |
| `application_fee_refund`   | `platform_earning_refund` |
| `stripe_fee`               | `fee`                     |
| `reserve_transaction`      | `connect_reserved_funds`  |
| `reserved_funds`           | `risk_reserved_funds`     |

## Referência sobre categorias de relatórios

Esta referência abrange os seguintes grupos de categorias de relatórios: