# Catégories et types de rapports

Comprendre les catégories sur les objets BalanceTransaction et leurs distinctions.

En savoir plus sur le champ `reporting_category` des objets `BalanceTransaction`, et en quoi il diffère du champ `type` et d’autres catégorisations.

## Le champ de catégorie de reporting

Le champ `reporting_category` de l’objet `BalanceTransaction` améliore le champ `type` en fournissant un regroupement plus utile pour la plupart des besoins en matière de finance et de reporting. Les sections suivantes décrivent les avantages du champ `reporting-category`.

##### Une décomposition plus détaillée de type=adjustment

L’attribut `reporting_category` sépare les transactions de solde de `type=adjustment` en plusieurs catégories différentes, y compris les litiges, les annulations de litiges et les remboursements échoués. De plus, il catégorise plusieurs types de frais et de remboursements de frais de plateforme *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) avec `reporting_category=fee`.

#### Une catégorie distincte pour les annulations de captures partielles

Si vous [autorisez et capturez les paiements séparément](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md), et que vous capturez un montant inférieur à l’autorisation initiale, vous verrez deux transactions de solde : une pour le montant total de l’autorisation, et une autre annulant la partie non capturée. (La somme des deux transactions de solde correspond à la partie capturée du paiement.)

La transaction de solde annulant la partie non capturée a pour `type=refund`, comme si vous aviez remboursé une partie d’une vente à un moment ultérieur. Pour permettre un traitement distinct de ces objets (par exemple, en les comptabilisant par rapport au montant de la vente initiale, plutôt que comme un remboursement distinct), nous les étiquetons avec la catégorie de reporting distincte `partial_capture_reversal`.

#### Consolidez plusieurs types dans des catégories communes

Si vous utilisez le champ `type`, les opérations sur solde résultant de paiements par carte sont identifiées avec `type=charge`, tandis que celles qui découlent d’[autres moyens de paiement](https://docs.stripe.com/payments/payment-methods/overview.md) sont identifiées avec `type=payment`. De la même façon, les remboursements et échecs de paiement par carte, par rapport aux autres moyens de paiement, présentent des types distincts, à savoir `refund` et `payment_refund`.

L’attribut `reporting_category` simplifie ces groupes de types (et d’autres), comme suit :

| Types d’opérations sur solde                                                                     | Catégorie de reporting |
| ------------------------------------------------------------------------------------------------ | ---------------------- |
| `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`    |

##### Des noms de catégories plus descriptifs

Nous avons renommé plusieurs types de transactions de solde pour plus de clarté :

| Type d’opération sur solde | Catégorie de reporting    |
| -------------------------- | ------------------------- |
| `application_fee`          | `platform_earning`        |
| `application_fee_refund`   | `platform_earning_refund` |
| `stripe_fee`               | `fee`                     |
| `reserve_transaction`      | `connect_reserved_funds`  |
| `reserved_funds`           | `risk_reserved_funds`     |

## Référence des catégories de reporting

Cette référence couvre les groupes suivants de catégories de reporting :