Nutzung für Abrechnungszwecke mit S3 aufzeichnenÖffentliche Vorschau
Melden Sie Nutzung aus Ihrem S3-Bucket in großen Mengen.
Sie können Zählerereignisse zur Nutzung von Ihrem S3 Bucket an Stripe senden. Stripe analysiert, validiert und wandelt die Dateiinhalte in Zählerereignisse um. Nachdem die Ereignisse aus Ihrer Datei erfolgreich hochgeladen wurden, zeigt Stripe diese auf Ihrer Abonnementrechnung an.
Sie können Ihre Zählerereignisse zur Nutzung in den Dateiformaten CSV, JSON oder JSONLINE hochladen.
Fügen Sie die folgenden Felder in Ihre Datei ein und vergewissern Sie sich, dass sie dem Zählerereignisschema folgen.
identifier
: Eine eindeutige Kennung für das Ereignis. Wenn keine Kennung angegeben ist, wird sie von Stripe generiert. Wir empfehlen, hierfür eine global eindeutige Kennung zu verwenden.timestamp
: Der Zeitpunkt des Ereignisses – gemessen in Sekunden in Unixzeit.event_
: Der Name des Zählerereignisses.name payload_
: Bei der Nutzlast handelt es sich um eine Reihe von Spalten, die Schlüsselnamen enthalten, die sich auf Kunden- und numerische Nutzungswerte beziehen.columns payload_
: Diese Spalte enthält die stripe_customer_id, für die das Ereignis erstellt wird.stripe_ customer_ id payload_
: Diese Spalte stellt den numerischen Nutzungswert des Zählerereignisses dar. Standardmäßig lautet der Spaltennamevalue payload_
. Sie können ihn jedoch so festlegen, dass er mit dem Namen des Feldes übereinstimmt, den Sie beim Erstellen des Zählerereignisses festgelegt haben (stellen Sie ihmvalue payload_
voran).
Benötigen Sie Unterstützung für andere Dateiformate?
Kontaktieren Sie uns, wenn Sie Dateien mit einer anderen Struktur oder in einem benutzerdefinierten Format hochladen möchten.
Dateien aus Ihrem Amazon S3-Bucket importieren
Nachdem Ihre Dateien vorbereitet wurden, können Sie den S3-Connector einrichten. Der S3-Connector fragt diese Dateien automatisch ab und verarbeitet sie. Stellen Sie bei der Konfiguration Ihres S3-Connectors sicher, dass Sie die richtige Datenvorlage auswählen.
- Wählen Sie für JSON-Dateien das Billing Meter Event Transaction Template – JSON aus.
- Wählen Sie für JSONLINE-Dateien das Billing Meter Event Transaction Template – JSONLINE aus.
- Wählen Sie für Dateien im CSV-Format Billing Meter Event Transaction Template – CSV aus.
Umgang mit ungültigen Zählerereignissen
Stripe verarbeitet Zählerereignisse asynchron und benachrichtigt Sie per Webhook, wenn wir bei der gemeldeten Nutzung Fehler festgestellt haben.
Stripe erstellt ein Ereignis vom Typ billing.
, das aktuelle Fehler bei der Verarbeitung von Zählerereignissen zusammenfasst. Sie können diese Ereignisse im Stripe-Dashboard anzeigen, indem Sie zur Seite Ereignisse navigieren. Sie können für diese Ereignisse auch automatisch Maßnahmen ergreifen, indem Sie sie mit einem Webhook-Endpoint überwachen.
Nachfolgend finden Sie ein Beispiel für das Ereignis.
{ type: "billing.meter.error_report.triggered", data: { object: { id: "err_123456" summary: "There are 2 invalid events", validation_start: 1724098690, validation_end: 1724098700, reason: { error_count: 2, error_types: [ { error_code: "METER_NOT_FOUND", error_count: 2, "sample_errors": [ { "error_message": "No meter was found matching event_name invalid_event_name.", "request": { "id": "req_123456", "idempotency_key": "idmpk_123456", } }, { "error_message": "No meter was found matching event_name invalid_event_name.", "request": { "id": "req_123457", "idempotency_key": "idmpk_123457" } } ] } ] } } } }
Überprüfen Sie Ihre hochgeladenen Dateien gemäß den Informationen in sample_
, korrigieren Sie die ungültigen Ereignisse und laden Sie Dateien mit Korrekturen zur erneuten Verarbeitung erneut hoch.