Interroger des données 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é

La table connected_accounts 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_accounts 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).

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.

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.

select
  id,
  business_name,
  requirements_currently_due,
  future_requirements_currently_due
from
  connected_accounts
where
  future_requirements_currently_due != ''

requirements_past_due, requirements_currently_due, requirements_eventually_due, future_requirements_past_due, future_requirements_currently_due et future_requirements_eventually_due sont des listes d’exigences de compte séparées par des virgules.

Données transactionnelles pour les comptes connectés

Les données de transaction et d’abonnement 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.

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

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

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 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 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 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_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.

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

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 à 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_group. Les informations relatives aux paiements, aux transferts et aux groupes de transfert sont disponibles dans le tableau connected_account_charges propre à Stripe Connect.