Interroger des données Connect
Utilisez Sigma et Data Pipeline pour récupérer des informations sur Connect.
Les plateformes Connect 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 propres à Stripe Connect sont disponibles dans les sections Connect du schéma. Si vous n’utilisez pas de plateforme Connect, ces tables ne s’affichent pas.
Informations sur le compte connecté![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
La table connected_
fournit une liste d’objets Account 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, le pays ou l’adresse e-mail de l’utilisateur.
L’exemple suivant utilise le tableau connected_
pour récupérer une liste de cinq comptes de personnes résidant aux États-Unis et dont les virements sont désactivés, car Stripe ne dispose pas des informations de vérification requises pour vérifier leur compte.
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,
Tous les champs obligatoires des comptes individuels aux États-Unis sont récupérés sous forme de colonnes. Cela vous permet de visualiser toutes les informations qui ont déjà été spécifiées et celles qui doivent l’être pour chaque compte. Consultez l’exemple de rapport ci-dessous (certaines colonnes ont été supprimées par souci de concision).
id | ville | … | id_provided | document_id | |
---|---|---|---|---|---|
acct_1xOD1Ab… | emilie.joubert@exemple.fr | San Francisco | … | true | file_RQAXTx4… |
acct_ZcHnqra… | isabelle.garcia@exemple.fr | … | false | file_AWSn4Vs… | |
acct_XK5ecFA… | nathalie.vincent@exemple.fr | Seattle | … | true | file_IcjHGR8… |
acct_noOqsGJ… | delphine.joule@exemple.fr | Austin | … | false | file_XUwXvJG… |
acct_1swyaUO… | vincent.larue@exemple.fr | … | false | file_vOtvjWd… |
Comptes ayant des exigences à satisfaire![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Le tableau connected_
contient également des informations sur les requirements
et les future_
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_
pour gérer les nouvelles exigences de vérification.
L’exemple suivant utilise le tableau connected_
pour récupérer la liste des comptes pour lesquels des mises à jour de vérification sont à venir.
select id, business_name, requirements_currently_due, future_requirements_currently_due from connected_accounts where future_requirements_currently_due != ''
requirements_
, requirements_
, requirements_
, future_
, future_
et future_
sont des listes d’exigences de compte séparées par des virgules.
id | business_name | requirements_currently_due | future_requirements_currently_due |
---|---|---|---|
acct_1IhjrUTNO5xMcNTf | RocketRides | business_profile.url | |
acct_1D3JJjxNbXKoJVx2 | Kavholm | individual.email,settings.payments.statement_descriptor | |
acct_1H19IGhs1r5lBKOk | FurEver | external_account | settings.payments.statement_descriptor |
acct_1wuosin7tRlX0zq3 | Pacha | business_profile.url | company.tax_id |
Données transactionnelles pour les comptes connectés![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Les données de transaction et d’abonnement relatives aux comptes connectés figurent dans les tableaux connected_
. 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_
, située dans la section Paiements, contient les données d’opération sur solde pour votre compte Stripe. La table connected_
, 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.
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 |
---|---|---|---|---|---|---|
acct_LwsQYRG… | txn_aanXB6Y… | -1 000 | usd | re_OGonIoY… | remboursement | |
acct_eAiGhSC… | txn_fORM5ns… | 1 000 | usd | ch_KwXobGz… | paiement | |
acct_cRN5PEp… | txn_CLCJHd2… | 1 000 | usd | ch_xlGlAc3… | paiement | |
acct_2wsEYOO… | txn_IBRr9YY… | 1 000 | eur | ch_Z4zl4t6… | paiement | |
acct_OL28Qvg… | txn_soQIjbl… | -1 000 | usd | re_5GUZRPx… | remboursement |
Consultez notre documentation relative aux transactions et aux abonnements 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Si votre plateforme crée des frais directs 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_
ou connected_
) pour rendre compte des frais directs.
Accédez au modèle de requête des paiements directs 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Si votre plateforme crée des paiements indirects 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 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_
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.
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 |
---|---|---|---|---|
ch_acct_tYZKdE3… | 1 000 | 1 000 | acct_Q4YTH6C… | |
ch_acct_b2wE4M3… | 800 | 800 | acct_Q0ubQ2V… | |
ch_acct_UgvUG6R… | 1 000 | 800 | acct_akHIgKA… | |
ch_acct_FVnmWA8… | 1 100 | 950 | acct_QB7hIzY… | |
ch_acct_sf0gxfD… | 1 100 | 1 100 | acct_YoUD6e0… |
Les informations relatives aux paiements et aux transferts des comptes connectés sont également disponibles dans les tables propres à Stripe Connect (par exemple, connected_
).
Paiements et transferts distincts![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Créez un rapport sur des paiements et transferts distincts à 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. 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_
. Les informations relatives aux paiements, aux transferts et aux groupes de transfert sont disponibles dans le tableau connected_
propre à Stripe Connect.