DOC-02 Audit intake specification

CSV export checklist.

Prepare only the fields required for deterministic reconciliation. Do not send credentials, card details, or unrelated customer information.

Input mode
Two CSV filesNo Stripe write accessEncoding
UTF-8

Download templates

Product usage templateevent, customer, metric, quantity, time, period Stripe billing templateline, invoice, quantity, amount, currency, period

Required schemas

Product usage CSV

event_id,customer_id,metric,quantity,occurred_at,billing_period,source,metadata

Stripe billed usage CSV

line_id,customer_id,metric,quantity,amount,currency,invoice_id,billing_period,source

Export requirements

Use UTF-8 CSV with exactly one header row.
Keep customer_id stable across both files.
Use the same billable unit for metric in both files.
Format billing_period as YYYY-MM.
Use ISO 8601 product timestamps, including timezone.
Include the complete billing period under review.
Confirm whether draft, void, test, or partial invoices are included.

Do not include

Card numbers, bank details, or payment method data.
API keys, tokens, passwords, or webhook secrets.
Customer names, emails, or addresses unless separately agreed.
Unrelated product metadata or files outside the audit period.

Before transfer

Confirm billing timezone and period boundaries.
Agree on a secure transfer channel.
Agree on the retention period and deletion date.