Créer des colonnes personnalisées à l'aide de métadonnées

Vous pouvez stocker et envoyer des informations supplémentaires à l’aide de métadonnées. Les métadonnées sont constituées de paires clé-valeur associées à des objets ou à des transactions. Les métadonnées vous permettent d’associer des informations personnalisées à des données Stripe, afin que vous puissiez stocker et récupérer des informations utiles en même temps que vos principales données de transaction.

Vous pouvez utiliser les métadonnées pour filtrer et récupérer des informations spécifiques de rapports Stripe, ce qui facilite la création de rapports ciblés visant à extraire des données précises.

En savoir plus sur les métadonnées.

Utiliser les métadonnées

Vous pouvez utiliser les métadonnées dans le cadre de votre intégration Stripe de différentes façons. Voici quelques cas d’usage possibles :

• Stockage des identifiants internes pour faire correspondre les objets Stripe aux objets de vos propres systèmes
• Rapprochement des données financières fournies par Stripe avec vos propres systèmes
• Ajout de contexte aux objets Stripe, p. ex. les paiements, pour faciliter le dépannage
• Création de rapports personnalisés et interrogation avancée des données Stripe dans Sigma

Consulter des exemples d’appels à l’API pour ces cas d’usage.

Sélectionner des métadonnées dans des rapports financiers

1. Accédez au rapport considéré, p. ex. Solde, Rapprochement des virements ou Activité.
2. Cliquez sur Télécharger.
3. Sélectionnez Toutes les colonnes.
4. Si des objets sont associés à des métadonnées, ils apparaissent dans la section Métadonnées correspondante.

Objets avec lesquels les métadonnées peuvent être utilisées

Vous pouvez utiliser les métadonnées aux fins de la création de rapports sur toute une gamme d’objets, en particulier les suivants : Charge, Refund, Invoice, Payment, PaymentIntent, Transfer, Product, Customer, Subscription, InvoiceItem, Price, TaxTransaction, CreditNote, Contract et ContractItem.

Résoudre les problèmes liés aux métadonnées manquantes

Des métadonnées peuvent être manquantes si la quantité de métadonnées dépasse la limite de 100 clés de métadonnées pouvant être affichées dans un téléchargement. Les colonnes de métadonnées incluses dans l’exportation contiennent les 100 clés les plus pertinentes qui ont été définies sur les objets correspondants.

Si vous avez cessé d’utiliser certaines clés et que vous en avez introduit de nouvelles par la suite, les clés les plus récentes ne seront pas intégrées à l’exportation. C’est le cas même si vous supprimez rétroactivement de vos objets Charge ou d’autres objets toutes les instances des anciennes clés. Les colonnes de métadonnées ne sont pas générées dynamiquement pendant le processus d’exportation. Elles sont établies lorsqu’une nouvelle clé est ajoutée, dans la limite de 100 clés.

Si la limite de 100 clés pour un objet est atteinte et que les clés ne sont pas toutes utilisées pour un objet précis au moment donné, contactez le service de support de Stripe. Demandez la suppression des clés inutilisées de l’objet pour activer le téléchargement du rapport avec les champs nécessaires.

Bonnes pratiques

Voici quelques recommandations :

• Définissez à l’avance votre stratégie de métadonnées pour éviter d’atteindre la limite de 100 clés
• Utilisez des conventions de dénomination cohérentes pour vos clés de métadonnées
• Vérifiez et nettoyez régulièrement les clés de métadonnées inutilisées
• Pour bien organiser vos métadonnées, songez à utiliser des préfixes pour différencier les types (par exemple, « customer_ », « order_ »)