S3 を使用して請求書の使用量を記録する公開プレビュー
S3 バケットの使用量イベントをまとめて報告します。
S3 ストレージバケットから Stripe にメーター使用量イベントを送信できます。Stripe はファイルの内容を解析・検証し、メーターイベントに変換します。ファイル内のイベントのアップロードが完了すると、Stripe はそのイベントをサブスクリプションの請求書に表示します。
メーター使用量イベントは、CSV、JSON、または JSONLINE ファイル形式でアップロードできます。
ファイルに次のフィールドを含め、Meter Event (メーターイベント) のスキーマに従っていることを確認してください。
identifier
: イベントの一意の ID。指定されていない場合は、Stripe が生成します。グローバルで一意の ID を使用することをお勧めします。timestamp
: イベントの時刻。Unix エポックからの経過秒数で計測されます。event_
: 従量イベントの名前。name payload_
: ペイロードは、顧客と使用量の数値を参照するためのキー名が含まれる一連の列です。columns payload_
: この列には、イベントが作成される対象の stripe_customer_id が含まれます。stripe_ customer_ id payload_
: この列は、従量イベントの使用量の数値を表します。デフォルトの列名はvalue payload_
です。ただし、従量イベントの作成時に使用するフィールドと一致するように設定することも可能です (その場合、先頭にvalue payload_
を付けます)。
異なるファイル形式のサポートが必要な場合
異なる構造のファイルやカスタム形式のファイルのアップロードをご希望の場合は、お問い合わせください。
Amazon S3 バケットからファイルをインポートする
ファイルの準備ができたら、S3 コネクターを設定できます。S3 コネクターは、これらのファイルを自動的にポーリングして処理します。 S3 コネクターを設定する際は、正しいデータテンプレートを選択してください。
- JSON 形式のファイルの場合は、Billing メーターイベント取引テンプレート (JSON) を選択します。
- JSONLINE 形式のファイルの場合は、Billing メーターイベント取引テンプレート (JSONLINE) を選択します。
- CSV 形式のファイルの場合は、Billing メーターイベント取引テンプレート (CSV) を選択します。
無効な従量イベントを処理する
Stripe は計測されたイベントを非同期で処理し、報告された使用量にエラーがあった場合には Webhook で通知します。
Stripe は、タイプが billing.
の Event を作成して、従量イベントの処理に関する最近のエラーをまとめています。これらのイベントを確認するには、Stripe ダッシュボードで Events ページに移動してください。また、Webhook エンドポイントでイベントをリッスンして、これらのイベントに自動的に対応することもできます。
以下のイベントの例をご覧ください。
{ 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" } } ] } ] } } } }
sample_
の情報に従ってアップロードしたファイルを確認し、無効なイベントを修正して、再処理のために修正したファイルを再度アップロードします。