# Rapport de rapprochement des virements

Autoriser les comptes connectés à consulter et à exporter les rapports de rapprochement des virements.

Le composant de rapport de rapprochement des virements permet aux comptes connectés de consulter et d’exporter des rapports qui rapprochent chaque [virement automatique](https://docs.stripe.com/connect/manage-payout-schedule.md) avec le lot de transactions qu’il règle. Ce composant affiche trois sous-rapports :

- **Récapitulatif du solde** : il affiche votre solde Stripe aux dates de début et de fin de la plage sélectionnée, ainsi qu’un récapitulatif de votre activité au cours de cette période.
- **Rapprochement des virements** : il détaille les virements automatiques reçus sur le compte bancaire appartenant au compte connecté pendant la période sélectionnée, les transactions étant regroupées par catégorie de reporting.
- **Rapprochement du solde final** : il détaille les transactions qui n’ont pas été réglées à la date de fin du rapport.

Les comptes connectés peuvent filtrer le rapport par plage de dates et par devise. Ils peuvent également exporter chaque sous-rapport sous forme de fichiers récapitulatifs ou détaillés au format CSV.

Ces sous-rapports sont similaires aux rapports [de rapprochement des virements pour les comptes Stripe directs](https://docs.stripe.com/reports/payout-reconciliation.md).

## Disponibilité des composants

Si un compte connecté n’utilise pas les paiements automatiques, le composant de rapport de rapprochement des virements n’affiche rien. Utilisez le rappel `onReportAvailabilityLoaded` pour détecter cet état et afficher votre propre état vide ou interface utilisateur alternative.

Si un compte connecté passe des virements automatiques aux virements manuels, ce composant cesse d’afficher ses données de virement. Si un compte connecté passe des virements manuels aux virements automatiques, ce composant n’affiche que les données relatives aux virements automatiques.

Le [composant de rapport sur le solde](https://docs.stripe.com/connect/supported-embedded-components/balance-report.md) affiche les données de virement pour tous les comptes connectés, quel que soit leur type de virement.

> Les comptes connectés n’ayant pas accès à [l’intégralité du Dashboard Stripe](https://docs.stripe.com/connect/stripe-dashboard.md) peuvent uniquement consulter les données à partir du 1er avril 2026, à moins que votre plateforme n’ait fait l’objet d’une mise à jour rétrospective spécifique.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

Lorsque vous [créez une session Account](https://docs.stripe.com/api/account_sessions/create.md), activez le rapport de rapprochement des virements en spécifiant `payout_reconciliation_report` dans le paramètre `components`.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[payout_reconciliation_report][enabled]=true"
```

Après avoir créé la session de compte et [initialisé ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), vous pouvez afficher le composant de rapport de rapprochement des virements dans le front-end&nbsp;:

#### JavaScript

```javascript
// Include this element in your HTML
const payoutReconciliationReport = stripeConnectInstance.create(
  "payout-reconciliation-report"
);
container.appendChild(payoutReconciliationReport);

// Optional: Set a callback to handle report availability.
// The payout reconciliation report is only available for accounts
// on automatic payouts. Use this callback to show your own empty
// state when the report is unavailable.
payoutReconciliationReport.setOnReportAvailabilityLoaded(
  ({ isReportAvailable }) => {
    if (!isReportAvailable) {
      // Hide the component container or show a custom message
      container.style.display = "none";
      document.getElementById("fallback-message").textContent =
        "Payout reconciliation reports are only available for accounts that " +
        "use automatic payouts.";
    }
  }
);
```

#### HTML + JS

| Méthode                         | Type                                     | Description                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `setOnReportAvailabilityLoaded` | `({isReportAvailable: boolean}) => void` | Rappel déclenché lorsque le composant a déterminé si le rapport de rapprochement des virements est disponible pour ce compte connecté. Renvoie «&nbsp;true&nbsp;» si le compte utilise des virements automatiques, et «&nbsp;false&nbsp;» s’il utilise des virements manuels. Utilisez cette méthode pour afficher le composant de manière conditionnelle ou afficher votre propre état vide. |

#### React

| Propriété React              | Type                                     | Description                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `onReportAvailabilityLoaded` | `({isReportAvailable: boolean}) => void` | Rappel déclenché lorsque le composant a déterminé si le rapport de rapprochement des virements est disponible pour ce compte connecté. Renvoie «&nbsp;true&nbsp;» si le compte utilise des virements automatiques, et «&nbsp;false&nbsp;» s’il utilise des virements manuels. Utilisez cette méthode pour afficher le composant de manière conditionnelle ou afficher votre propre état vide. |

## Comptes connectés à plusieurs plateformes

Pour les comptes connectés qui ne sont pas contrôlés exclusivement par votre plateforme&nbsp;:

- Le rapport comprend les transactions de toutes les plateformes auxquelles le compte est connecté.
- Le compte connecté doit effectuer une [authentification d’utilisateur](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) avant de consulter le rapport.