# Interroger les données des comptes connectés Utilisez Sigma et Data Pipeline pour récupérer les informations sur les comptes connectés. Les plateformes *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) peuvent créer des rapports sur leurs comptes connectés à l’aide de Sigma ou de Data Pipeline. Vous pouvez écrire des requêtes qui s’exécutent sur l’intégralité de votre plateforme de la même façon que pour votre propre compte Stripe. Des groupes supplémentaires de tables spécifiques à Connect dans le schéma se trouvent dans les sections **Connect** du schéma. Si vous n’exploitez pas de plateforme Connect, ces tables ne sont pas affichées. ## Informations sur le compte connecté La table `connected_accounts` fournit une liste d’objets [Account](https://docs.stripe.com/api.md#account_object) contenant des informations sur les comptes connectés. Elle stocke les informations de compte de l’ensemble des comptes de votre plateforme, comme le [nom de l’entreprise](https://docs.stripe.com/api.md#account_object-business_name), le [pays](https://docs.stripe.com/api.md#account_object-country) ou l’[adresse e-mail](https://docs.stripe.com/api.md#account_object-email) de l’utilisateur. L’exemple suivant utilise le tableau `connected_accounts` pour récupérer une liste de cinq comptes de entrepreneur individuel résidant aux États-Unis et dont les *virements* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) sont désactivés, car Stripe ne dispose pas des [informations de vérification requises](https://docs.stripe.com/connect/required-verification-information.md) pour [vérifier leur compte](https://docs.stripe.com/connect/identity-verification.md). ```sql select id, email, legal_entity_address_city as city, legal_entity_address_line1 as line1, legal_entity_address_postal_code as zip, legal_entity_address_state as state, legal_entity_dob_day as dob_day, legal_entity_dob_month as dob_month, legal_entity_dob_year as dob_year, legal_entity_first_name as first_name, legal_entity_last_name as last_name, legal_entity_ssn_last_4_provided as ssn_provided, tos_acceptance_date as tos_date, tos_acceptance_ip as tos_ip, legal_entity_personal_id_number_provided as id_provided, legal_entity_verification_document_id as document_id from connected_accounts where legal_entity_type = 'individual' and payouts_enabled = false and country = 'US' limit 5 ``` Tous les champs requis pour les comptes individuels aux États-Unis sont récupérés sous forme de colonnes. Cela vous permet de voir quelles informations ont été fournies et lesquelles sont nécessaires pour chaque compte. Cet exemple est illustré dans le rapport ci-dessous (certaines colonnes ont été omises par souci de concision). | id | Adresse e-mail | ville | … | id_provided | document_id | | ------------- | --------------------------- | ------------- | - | ----------- | ------------- | | acct_orWziM4… | florence.martin@exemple.com | San Francisco | … | véritable | file_orWziM4… | | acct_orWziM4… | isabelle.garcia@exemple.fr | | … | false | file_orWziM4… | | acct_orWziM4… | nathalie.vincent@exemple.fr | Seattle | … | véritable | file_orWziM4… | | acct_orWziM4… | delphine.joule@exemple.fr | Austin | … | false | file_orWziM4… | | acct_orWziM4… | vincent.larue@exemple.fr | | … | false | file_orWziM4… | ## Comptes ayant des exigences à satisfaire Le tableau `connected_accounts` contient également des informations sur les `requirements` et les `future_requirements` des comptes connectés. Utilisez ce tableau afin de récupérer les listes des comptes pour lesquels des exigences sont actuellement attendues et qui seront bientôt désactivés. Utilisez les colonnes `future_requirements` pour [gérer les nouvelles exigences de vérification](https://docs.stripe.com/connect/handle-verification-updates.md). L’exemple suivant utilise le tableau `connected_accounts` pour récupérer la liste des comptes pour lesquels des mises à jour de vérification sont à venir. ```sql select id, business_name, requirements_currently_due, future_requirements_currently_due from connected_accounts where future_requirements_currently_due != '' ``` | id | business_name | requirements_currently_due | future_requirements_currently_due | | --------------------- | ------------- | -------------------------- | ------------------------------------------------------- | | acct_1orWziM4j7CiRL8J | RocketRides | | business_profile.url | | acct_1orWziM4j7CiRL8J | Kavholm | | individual.email,settings.payments.statement_descriptor | | acct_1orWziM4j7CiRL8J | FurEver | external_account | settings.payments.statement_descriptor | | acct_1orWziM4j7CiRL8J | Pasha | business_profile.url | company.tax_id | Les colonnes disponibles pour interroger les informations sur les `requirements` et les `future_requirements` sont des listes d’exigences du compte séparées par des virgules. | exigences : | future_requirements | | ----------------------------------- | ------------------------------------------ | | `requirements_past_due` | `future_requirements_past_due` | | `requirements_currently_due` | `future_requirements_currently_due` | | `requirements_eventually_due` | `future_requirements_eventually_due` | | `requirements_pending_verification` | `future_requirements_pending_verification` | ## Données transactionnelles pour les comptes connectés Sigma et Data Pipeline proposent un large éventail de [modèles de requêtes](https://dashboard.stripe.com/sigma/queries/templates) pour les plateformes Connect. Utilisez-les pour générer vos tout premiers rapports sur vos comptes connectés. Les données de [transaction](https://docs.stripe.com/stripe-data/query-transactions.md) et d’[abonnement](https://docs.stripe.com/stripe-data/query-billing-data.md) relatives aux comptes connectés figurent dans les tableaux `connected_account_`. Les données disponibles pour les comptes connectés sont organisées et structurées de la même manière que celles de votre propre compte. Par exemple, la table `balance_transactions`, située dans la section **Paiements**, contient les données d’opération sur solde pour votre compte Stripe. La table `connected_account_balance_transactions`, située dans la section **Connect - Paiements**, contient les données d’opération sur solde pour vos comptes connectés. Chaque table propre à Stripe Connect comporte une colonne `account` supplémentaire dans laquelle figure l’identifiant d’un compte connecté. Vous pouvez l’utiliser lorsque vous joignez des tables dans le cadre de requêtes avancées. L’exemple suivant repose sur la requête par défaut chargée dans l’éditeur. Plutôt que de récupérer les 10 opérations sur solde les plus récentes sur votre compte, elle réalise cette action sur l’ensemble des comptes connectés de votre plateforme. ```sql select date_format(created, '%m-%d-%Y') as day, account, -- Added to include corresponding account identifier id, amount, currency, source_id, type from connected_account_balance_transactions -- Changed to use Connect-specific table order by day desc limit 5 ``` | jour | compte | id | montant | devise | source_id | type | | ---------- | ------------- | ------------ | ----------- | ------ | ----------- | ------------- | | 20/03/2026 | acct_orWziM4… | txn_orWziM4… | -1 000 | USD | re_orWziM4… | remboursement | | 20/03/2026 | acct_orWziM4… | txn_orWziM4… | 1 000 | USD | ch_orWziM4… | paiement | | 20/03/2026 | acct_orWziM4… | txn_orWziM4… | 1 000 | USD | ch_orWziM4… | paiement | | 20/03/2026 | acct_orWziM4… | txn_orWziM4… | 1 000 | EUR | ch_orWziM4… | paiement | | 20/03/2026 | acct_orWziM4… | txn_orWziM4… | -1 000 | USD | re_orWziM4… | remboursement | Consultez notre documentation relative aux [transactions](https://docs.stripe.com/stripe-data/query-transactions.md) et aux [abonnements](https://docs.stripe.com/stripe-data/query-billing-data.md) pour en savoir plus sur l’interrogation des données de transaction et d’abonnement. Vous pouvez ensuite compléter ou adapter vos requêtes avec les informations propres à Stripe Connect pour créer des rapports sur les comptes connectés. ### Interroger des paiements sur des comptes connectés Utilisez Sigma ou Data Pipeline pour générer des rapports sur les mouvements de fonds vers vos comptes connectés. La marche à suivre dépend de l’approche adoptée par votre plateforme en matière de création des paiements. ## Paiements directs Si votre plateforme crée des [frais directs](https://docs.stripe.com/connect/direct-charges.md) sur un compte connecté, ils apparaissent sur le compte connecté et non sur votre plateforme. C’est comme si un compte connecté faisait lui-même une demande d’imputation. Les plateformes peuvent utiliser les tables spécifiques à Connect (par exemple, `connected_account_charges` ou `connected_account_balance_transactions`) pour rendre compte des frais directs. Accédez au [modèle de requête des paiements directs](https://dashboard.stripe.com/sigma/queries/templates/Direct%20charges) pour récupérer des informations par catégories sur les commissions de plateforme perçues via les paiements directs et générer un rapport sur le compte connecté, le transfert et le paiement créé. ## Paiements indirects Si votre plateforme crée des [paiements indirects](https://docs.stripe.com/connect/destination-charges.md) au nom de comptes connectés, les informations relatives aux paiements sont disponibles dans les données de votre propre compte. Un transfert distinct des fonds vers le compte connecté est automatiquement créé, ce qui crée un paiement sur ce compte. Par exemple, le [modèle de requête des paiements indirects](https://dashboard.stripe.com/sigma/queries/templates/Destination%20charges) crée un rapport sur les transferts liés aux paiements indirects effectués par votre plateforme. Pour analyser le mouvement de fonds d’un paiement indirect vers un compte connecté, vous pouvez joindre la colonne `transfer_id` de la table `charges` à la colonne `id` de la table `transfers`. Cet exemple comprend l’identifiant et le montant du paiement d’origine, le montant transféré vers le compte connecté, ainsi que les identifiants du compte connecté et le paiement qui en résulte. ```sql select date_format(date_trunc('day', charges.created), '%y-%m-%d') as day, charges.id, charges.amount as charge_amount, transfers.amount as transferred_amount, transfers.destination_id from charges inner join transfers on transfers.id=charges.transfer_id order by day desc limit 5 ``` | jour | id | charge_amount | transferred_amount | destination_id | | ---------- | ---------------- | ------------- | ------------------ | -------------- | | 20/03/2026 | ch_acct_orWziM4… | 1 000 | 1 000 | acct_orWziM4… | | 20/03/2026 | ch_acct_orWziM4… | 800 | 800 | acct_orWziM4… | | 20/03/2026 | ch_acct_orWziM4… | 1 000 | 800 | acct_orWziM4… | | 20/03/2026 | ch_acct_orWziM4… | 1 100 | 950 | acct_orWziM4… | | 20/03/2026 | ch_acct_orWziM4… | 1 100 | 1 100 | acct_orWziM4… | Les informations relatives aux paiements et aux transferts des comptes connectés sont également disponibles dans les tables propres à Stripe Connect (par exemple, `connected_account_charges`). ### Paiements et transferts distincts Créez un rapport sur des [paiements et transferts distincts](https://docs.stripe.com/connect/separate-charges-and-transfers.md) à l’aide d’une approche similaire à celle du paiement indirect. Tous les paiements sont créés sur le compte de votre plateforme, avec des fonds transférés séparément vers des comptes connectés à l’aide de [groupes de transfert](https://docs.stripe.com/connect/separate-charges-and-transfers.md). Le paiement créé sur le compte connecté précise le transfert et le groupe de transfert. Les tableaux `charges` et `transfers` comprennent une colonne `transfer_group`. Les informations relatives aux paiements, aux transferts et aux groupes de transfert sont disponibles dans le tableau `connected_account_charges` propre à Stripe Connect.