Skip to main content
photon project billing covers what a project is subscribed to and what it has been charged. For the card on file, see the organization payment method. Browse the automatic command reference.

​
Review current billing

overview shows subscriptions, every entitlement with its version, and current-period usage. Invoices are issued to the project’s organization, so invoice list shows the organization’s invoices.
The API returns amounts in cents. Human output displays them as decimal currency units, so 100 cents appears as 1.00. JSON keeps the original integer amountCents and totalCents values, so scripts should read those.

​
Purchase a plan

Categories use the API’s lowercase format. Plan codes are trimmed and may contain any non-control text up to 64 characters.
Purchase polls PENDING and RUNNING snapshots until Photon returns a terminal result or you press Ctrl-C. A terminal failure is reported on stderr and exits 1, and leaves no recovery-queue entry — fix the cause and purchase again with a fresh idempotency key. Check a long-running purchase by its operation ID:
Billing operation IDs always start with pho_bop_.

​
Cancel and resume a subscription

The API’s response is authoritative. If it returns cancellationScheduled: false or resumed: false, the CLI reports that nothing changed rather than claiming success — check the category and the current subscription state.
The organization routes use the project’s own organization, read with GET /v1/projects/{projectId}, not the selected organization.