Billing sync
How Valqio connects runtime usage outcomes to billing-provider workflows.
Valqio does not replace your billing provider. Billing providers invoice, collect payment, manage taxes, and hold commercial records. Valqio records the runtime usage, decisions, reservations, commits, releases, and evidence those billing workflows need.
What Valqio sends downstream
Valqio can prepare billing-facing records from runtime activity:
- customer and environment context
- product action, meter, or usage-control key
- quantity and billing period
- allow, deny, commit, release, or usage outcome
- idempotency key and request identity
- draft invoice preview lines
- export readiness and Stripe provider status
Use this evidence to explain how runtime activity became a billable or non-billable billing record.
Draft invoices
Draft invoices are reviewable previews. They help finance and operators answer:
- Which customer generated usage in the period?
- Which meters or product actions contributed to the preview?
- Which usage lines are ready to export?
- Which lines are blocked, failed, or need review?
- Which Stripe connection will receive the export?
Nothing should be sent to a billing provider until the draft invoice is ready and an authorized operator or automation exports it.
Provider boundary
| Responsibility | Valqio | Billing provider |
|---|---|---|
| Decide before product work runs | Yes | No |
| Record runtime evidence | Yes | No |
| Track usage transaction lifecycle | Yes | No |
| Prepare usage for billing sync | Yes | Sometimes |
| Create invoices | No | Yes |
| Collect payment | No | Yes |
| Manage taxes and commercial records | No | Yes |
This boundary is deliberate. Billing sends invoices. Valqio decides whether the product action should run and records what happened.
Operational checks
Before exporting usage, verify:
- The customer has the expected billing relationship.
- The usage period matches the invoice period.
- The draft invoice lines match runtime evidence.
- The Stripe connection is active.
- Export readiness has no blocking errors.
- Support can trace a line back to decision evidence or runtime activity.
If billing sync is delayed, your app should still call Valqio before product work. The runtime decision path remains the authority for whether work should run.
Draft invoice export path
For billing provider export, currently Stripe, review:
- The draft invoice customer, period, currency, and total.
- Usage source context for each metered line.
- Recent usage by meter for the same customer and period.
- Exportable lines and lines that are blocked or failed.
- The selected Stripe connection.
- Provider IDs returned by Stripe and export evidence after a successful export.
This gives finance a review step without moving decision authority into the billing provider.