Benutzerdefinierte Spalten mithilfe von Metadaten erstellen

Sie können ergänzende Informationen über Metadaten speichern und versenden. Metadaten bestehen aus Schlüsselwertpaaren, die Objekten oder Transaktionen zugeordnet sind. Mit Metadaten können Sie nutzerdefinierte Informationen an Stripe-Daten anhängen, sodass Sie relevante Details neben Ihren zentralen Transaktionsdaten speichern und abrufen können.

Sie können Metadaten verwenden, um bestimmte Informationen aus Stripe-Berichten zu filtern und abzurufen, was die Erstellung gezielter Berichte zum Extrahieren präziser Daten erleichtert.

Erfahren Sie mehr über Metadaten.

Metadaten verwenden

Sie können Metadaten als Teil Ihrer Stripe-Integration auf verschiedene Arten verwenden. Einige mögliche Anwendungsfälle:

• Speichern interner IDs, um Stripe-Objekte mit Objekten in Ihren eigenen Systemen abzugleichen
• Von Stripe bereitgestellte Finanzdaten mit Ihren eigenen Systemen abgleichen
• Hinzufügen von Kontext zu Stripe-Objekten, wie Zahlungen, zur Unterstützung bei der Fehlerbehebung
• Benutzerdefinierte Berichte und erweiterte Abfragen von Stripe-Daten in Sigma

Siehe Beispiel-API-Aufrufe für diese Anwendungsszenarien.

Metadaten in Finanzberichten auswählen

1. Gehen Sie zum entsprechenden Bericht, , z. B. Salden, Auszahlungsabgleich oder Aktivität.
2. Klicken Sie auf Herunterladen.
3. Wählen Sie Alle Spalten aus.
4. Wenn Sie über Objekte verfügen, an die Metadaten angehängt sind, werden diese im entsprechenden Abschnitt „Metadaten“ angezeigt.

Wo Metadaten verwendet werden können

Sie können Metadaten für Berichtszwecke über eine Reihe von Objekten hinweg verwenden, insbesondere: Zahlung, Rückerstattung, Rechnung, Zahlung, PaymentIntent, Transfer, Produkt, Kunde/Kundin, Abonnement, InvoiceItem, Preis, TaxTransaction, CreditNote, Vertrag und ContractItem.

Fehlerbehebung bei fehlenden Metadaten

Möglicherweise fehlen Metadaten, wenn die Menge der Metadaten das Limit von 100 Metadatenschlüsseln überschreitet, die in einem Download angezeigt werden können. Die Metadatenspalten, die in den Export aufgenommen werden, enthalten die relevantesten 100 Schlüssel, die für die entsprechenden Objekte definiert wurden.

Wenn Sie die Verwendung bestimmter Schlüssel eingestellt und anschließend neue Schlüssel eingeführt haben, werden die neueren Schlüssel nicht in den Export aufgenommen. Dies gilt auch dann, wenn Sie alle Instanzen der älteren Schlüssel rückwirkend aus Ihren Gebühren oder anderen Objekten entfernen. Die Metadaten-Spalten werden während des Exportvorgangs nicht dynamisch generiert, sondern beim Hinzufügen eines neuen Schlüssels festgelegt, bis zu einer maximalen Anzahl von 100 Schlüsseln.

Wenn die Obergrenze von 100 Schlüsseln für ein Objekt erreicht ist und derzeit nicht alle Schlüssel für ein bestimmtes Objekt verwendet werden, kontaktieren Sie den Stripe-Support. Fordern Sie das Entfernen ungenutzter Schlüssel aus dem Objekt an, um den Download des Berichts mit den erforderlichen Feldern zu ermöglichen.

Metadatenzugriff für Berichte zu verbundenen Konten

Metadatenspalten sind in den Berichtsexporten von Connect-Konten aus dem Dashboard nicht enthalten, da die Gesamtzahl der Metadatenschlüssel in den gesamten verbundenen Konten den Höchstwert von 100 Schlüsseln überschreiten kann. Verwenden Sie die Stripe Reporting API, um auf diese Metadatendetails zuzugreifen.

Best Practices

Hier sind einige Empfehlungen:

• Planen Sie Ihre Metadatenstrategie im Voraus, um zu vermeiden, dass die Grenze von 100 Schlüsseln erreicht wird
• Verwenden Sie einheitliche Namenskonventionen für Ihre Metadatenschlüssel
• Nicht verwendete Metadatenschlüssel regelmäßig überprüfen und bereinigen
• Erwägen Sie zur besseren Organisation die Verwendung von Präfixen für verschiedene Arten von Metadaten (z. B. „customer_“, „order_“).