Public training path

Complete User Guide

Commerce & Billing · Beginner-friendly walkthrough

Commerce and Billing is the control area for what your account can use, how usage is paid for, how invoices are tracked, and how your billing identity is stored. Most confusion disappears when users separate four questions: what plan am I on, how many credits...

Next best action

Preview the guidance here, then create an account to save workspaces, unlock guided execution, and continue inside the platform.

Start with the first section Create account to continue

Sections

2 guided blocks

Read Time

5 min focused read

Coverage

206 searchable doc sections

commercebillingtutorialcreditssubscriptioninvoice

Section 1 of 2

How to Manage Plans, Credits, Billing Identity, and Subscription Changes

commercebillingtutorialcreditssubscription

Plan entitlements

Your plan decides which services, limits, and support layers are available to the account or organization.

Credit balance

Credits act as execution fuel for prompt runs, batch jobs, comparisons, and some helper actions.

Billing profile

Organization and invoice identity details keep invoices, certificates, and administrative records consistent.

Invoices and subscription state

Use billing history to confirm purchases, download invoice records, and see cancellation or renewal status.

They mix plan limitations with credit shortages.

They assume a payment delay means the payment failed, when the webhook may still be provisioning.

They forget to complete the billing profile and later wonder why administrative records feel incomplete.

They read raw usage without checking whether the activity was valuable work or avoidable rework.

Step 1: Confirm your plan first

Check which plan the account is on and what that unlocks or limits before debugging anything else.

Step 2: Review available credits and recent usage

If a run failed or was blocked, compare the remaining balance with recent activity so you know whether this is really a fuel problem.

Step 3: Complete or verify billing identity

Make sure the billing profile has the organization and address details needed for invoices and administrative consistency.

Step 4: Check invoice and purchase history

Use invoice records and subscription state to confirm whether a purchase, renewal, or cancellation was actually processed.

Step 5: Wait briefly for provisioning before escalating

Recent purchases can take a short moment to appear if the payment event is still being fulfilled through the webhook flow.

Step 6: Escalate with the right evidence

If something still looks wrong, bring the invoice number, purchase timing, current balance, and the exact symptom. That shortens support time dramatically.

Do This

Check plan, credits, billing profile, and invoices as separate troubleshooting steps.

Use Prompt Architect and PromptForge discipline to reduce avoidable repeat runs and wasted credits.

Keep the billing profile current if the organization name or legal details change.

Use invoice or hosted billing records instead of screenshots whenever possible.

Avoid

Do not assume every failed run is caused by insufficient credits.

Do not panic if credits do not appear instantly after checkout; provisioning can take a short moment.

Do not leave billing identity empty if the account is used for team purchasing or reimbursement.

Do not optimize cost only by limiting usage; also improve prompt quality and workflow discipline.

Section 2 of 2

Billing Fields, Invoice Flows, Credit Types, and Subscription State

commercebillinginvoicesubscriptioncredits

Billing becomes much easier once you separate static identity data from dynamic quota data. The billing profile stores who the invoice belongs to. The quota and subscription panels show what the account can currently consume. The invoice list proves what was billed. Those are related, but they are not the same problem.

Subscription state

The billing area shows the current plan, whether the subscription is active, and when the current term is expected to end.

Credit balances

AI credits, consultation credits, mentoring credits, and referral-generated credits each answer different operational questions.

Billing identity

Company name, registry code, VAT data, address, and company toggle determine how invoices and administrative records are framed.

Invoices

Invoices can open from hosted or PDF sources and also fall back to a direct download endpoint when needed.

company_name: the legal or trading entity to appear on billing records.

registry_code and vat_id: organization identifiers used for invoicing and finance operations where relevant.

country, address_line1, city, postal_code: the core billing identity fields that should not be left half-complete for team or reimbursable usage.

is_company: tells the platform whether the billing identity should be treated as a company profile.

Verify the subscription layer

Check the active plan and whether the subscription is currently active before diagnosing missing access.

Check credit balances by type

Confirm whether the issue is AI execution fuel, consultation runway, mentoring runway, or simply a plan entitlement question.

Update billing identity

Keep the organization and address data current so invoices and administrative records remain clean.

Use invoices as the source of truth

When a payment question arises, start from the invoice or hosted billing record rather than from screenshots or memory.

Pro Tip: Billing and usage are different layers

A healthy billing profile does not guarantee available credits, and a healthy credit balance does not guarantee the right plan entitlements. Check both layers before concluding something is broken.

Credit Management Guide

Academy v4.0 · Interactive Documentation · Beginner Mode