Interroger les données de frais Stripe

Utilisez Sigma ou Data Pipeline pour récupérer des informations sur les frais de transaction et de produit prélevés sur votre solde Stripe.

Utilisez la table itemized_fees pour obtenir une ventilation complète et granulaire de tous les frais facturés ou déduits de votre solde Stripe. Par exemple, si une transaction de solde indique des frais de 2 USD pour un paiement par carte bancaire, vous pouvez interroger cette transaction dans la table itemized_fees pour comprendre la ventilation. Vous pouvez également utiliser la table pour comprendre le total des frais payés à Stripe au cours d’une période donnée.

Voici la liste des colonnes disponibles dans la table itemized_fees :

Colonne	Description
balance_transaction_created	Heure (en UTC) à laquelle l’opération sur solde a affecté votre solde Stripe.
balance_transaction_id	L’ID de l’opération sur solde qui a débité les frais de votre solde.
balance_transaction_description	La description de l’opération sur solde contenant les frais.
incurred_by	ID de l’objet ayant donné lieu à ces frais, le cas échéant. Utilisez le champ `incurred_by_type` field pour déterminer le type de cet objet.
incurred_by_type	Le type d’objet référencé par `incurred_by`. Correspond au champ de l’objet dans les API (Charge, Refund, Invoice, etc).
amount	Frais facturés pour cette activité, exprimés dans l’unité principale de la devise. Le montant des taxes n’est pas inclus.
taxe	Composante fiscale des frais payés, exprimée dans l’unité principale de la devise.
devise	Code ISO de la devise dans laquelle le montant et la taxe sont exprimés.
incurred_at	Heure (en UTC) à laquelle les frais ont été facturés, en fonction de la date de l’événement qui en est à l’origine.
activity_start_date	Pour les frais calculés à partir d’une activité s’étendant sur une certaine période, il s’agit de la date de début de l’activité (en UTC).
activity_end_date	Pour les frais calculés à partir d’une activité s’étendant sur une certaine période, il s’agit de la date de fin de l’activité (en UTC).
product_feature_description	Le produit ou la fonctionnalité associé(e) aux frais.

L’exemple suivant montre comment extraire des informations sur les cinq dernières transactions de frais :

select
  date_format(date_trunc('day', incurred_at), '%m-%d-%Y') as day,
  balance_transaction_id,
  amount,
  tax,
  product_feature_description
from
  itemized_fees
order by
  incurred_at desc
limit 5;

Pour obtenir une vue plus granulaire de votre activité, associez la table itemized_fees à d’autres tables du schéma. Par exemple, joignez la table balance_transactions à la table itemized_fees pour obtenir des informations sur les frais pour chaque opération sur solde.

Voici un exemple illustrant la manière d’associer ces tables pour obtenir les différents types de frais appliqués et les descriptions détaillées de ces frais :

select
  date_format(date_trunc('day', itemized_fees.balance_transaction_created), '%m-%d-%Y') as day,
  balance_transactions.id as balance_transaction_id,
  balance_transactions.reporting_category as reporting_category,
  itemized_fees.amount as fee_amount,
  itemized_fees.tax as tax_amount
from
  balance_transactions
inner join
  itemized_fees on balance_transactions.id = itemized_fees.balance_transaction_id
order by
  day desc
limit 5;

Frais payés par les comptes connectés

Si vous avez un compte de plateforme avec Stripe Connect, utilisez la table connected_account_itemized_fees pour avoir un aperçu des frais payés par vos comptes connectés.

Comme la table itemized_fees table, la table connected_account_itemized_fees fournit un enregistrement granulaire des transactions de frais, mais du point de vue de vos comptes connectés. Ces jeux de données ont pour la plupart des attributs communs, bien que le jeu de données connected_account_itemized_fees comporte une colonne de account supplémentaire. Cette colonne account permet aux comptes de la plateforme de suivre les frais payés par chacun de leurs comptes connectés.

Pour identifier toutes les transactions de frais associées à un compte connecté spécifique sur une période donnée, utilisez la table connected_account_itemized_fees. Voici un exemple de requête permettant d’obtenir les 10 comptes connectés ayant payé le plus de frais au total :

select
  account,
  sum(amount) as total_fees
from
  connected_account_itemized_fees
where
  incurred_at between 'start_date' and 'end_date'
group by
  account
order by
  total_fees desc
limit 10;

Remplacez start_date et end_date par les dates spécifiques que vous souhaitez analyser dans le format YYYY-MM-DD. Cette requête additionne le total des frais payés par chaque compte connecté dans la plage de dates spécifiée et renvoie les 10 premiers comptes avec les frais totaux les plus élevés.