CH·02CLI reference

deeprelay billing subscribe

Start a subscription (prints a Stripe Checkout link)

Synopsis

Starts a subscription to a deeprelay plan. Prints a Stripe Checkout link; open it in a browser to pay.

--plan picks the plan by key — flat (Base) is the default, plus is the bigger one. deeprelay billing plans lists every plan on offer with its price and allowance. Already subscribed and want more? That is deeprelay billing upgrade, not a second subscription.

The link is the honest shape of this command. Checkout is a hosted page — the card details go to Stripe, never through this CLI or our servers — so there is no headless way to complete a purchase. What the CLI can do is everything around it: quote the price before you commit, refuse a second subscription you already have, and confirm afterwards that the plan actually started.

Base — $0.99 / month

Open this link to finish subscribing:

  https://checkout.stripe.com/c/pay/cs_live_...

The page is hosted by Stripe; the subscription starts once payment completes.
Check it landed with `deeprelay billing subscription`.

The price shown is read live from Stripe, not hardcoded. If it is missing, the plan name prints alone — that means the price could not be read right now, not that the plan is free. The Checkout page always shows the real figure.

deeprelay models list marks which models the plan covers (plan_covered in JSON). Models outside that list still bill pay-as-you-go from your credit balance while you are subscribed — the subscription does not make every model free, and deeprelay preflight will warn you before any call that would be charged.

deeprelay billing subscription prints the plan's quota even when you are not subscribed, so you can see what you would be getting.

The subscription becomes active when Stripe confirms payment, which is usually immediate but is not synchronous with this command. Confirm with:

deeprelay billing subscription

Paying from your balance

--from-balance pays for the plan on the spot from your deposited balance instead of printing a Checkout link. It needs --plan, because no Stripe page shows you the price first; check it with deeprelay billing plans.

Paid for Base ($0.99 / month) from your deposited balance.
The full price was taken from your balance and a new billing period started now.
Renewals are paid from your balance when it covers the full price; otherwise your saved payment method is charged.

Plan                 Base — $0.99 / month
Status               subscribed (active)
...

Only deposited funds pay. Free credit (referral and promo credit, credit codes, post rewards, staff grants, downtime credits, adjustments) pays for usage, never for a plan. Card and UPI deposits count 24 hours after they land. deeprelay billing renew-from-balance shows the split.
All or nothing, in US dollars. If the deposited balance does not cover the full price, nothing is charged (402 insufficient_balance, with the split in the message).
Renewals. A plan started this way renews from balance by default whenever the balance covers the full price, and charges your saved payment method otherwise. Change that with deeprelay billing renew-from-balance off.
Already on a plan? Naming a bigger plan upgrades it, exactly like deeprelay billing upgrade --from-balance.

--from-balance cannot be combined with --upi, --card, --success-url or --cancel-url.

Switching between dollars and rupees

On an org that is already subscribed, --upi (on a dollar plan) or --card (on a rupee plan) switches how the same plan is billed instead of starting a second subscription. The link saves your card or approves UPI AutoPay; nothing is charged then. The switch completes once you approve: your current billing ends with no refund or extra charge, and the same plan carries on in the new currency, first charged on your renewal date (this month is already paid).

Base: switch to card billing (dollars, card or Link)
First dollar charge on Nov 8, 2026; this month is already paid.

Open this link to save your card (nothing is charged now):

A switch is refused within two days of your renewal, while the plan is set to cancel (run deeprelay billing resume first), and while an upgrade is waiting on its UPI payment.

To change how you pay, use deeprelay billing payment-methods; to cancel at the end of the paid period, deeprelay billing cancel (undo with deeprelay billing resume); for invoices, deeprelay billing portal.

Permissions and errors

Requires an org admin API key with the billing write scope — subscribing spends organization money. A member key gets 403.

Situation	Result
Already subscribed	`409` — one subscription per organization; use `deeprelay billing upgrade` to change plan
Unknown plan key, or one this deployment does not offer	`400 unknown_plan`
`--from-balance`: the deposited balance does not cover the full price	`402 insufficient_balance` — nothing was charged
`--from-balance`: the account is paused	`403 account_frozen`
`--from-balance`: the price changed mid-payment, or the payment could not complete	`409 price_changed` / `502 payment_failed` — your balance was not charged; try again
Subscriptions not configured on this deployment	`503`
Not an org admin	`403`

Examples

# Start a Base subscription.
deeprelay billing subscribe

# Start on Plus instead.
deeprelay billing subscribe --plan plus

# Pay for Base now from your deposited balance (no link).
deeprelay billing subscribe --plan flat --from-balance

# Get just the URL, for a script that opens a browser itself.
deeprelay billing subscribe --output json | jq -r .checkout_url

# Return to a specific console page.
deeprelay billing subscribe \
  --success-url https://deeprelay.ai/cloud/billing?subscription=success \
  --cancel-url  https://deeprelay.ai/cloud/billing

--success-url and --cancel-url default to the URLs the deployment is configured with; you rarely need to set them. When set, they must be on the deployment's own dashboard site: Checkout carries deeprelay's branding, so a URL on any other site is refused (422 validation_failed).

deeprelay billing subscribe [flags]

Options

      --cancel-url string              Where Stripe returns if the customer abandons checkout; must be on the dashboard site (defaults to the server's configured URL)
      --card                           Pay in dollars by card or Link. On a rupee (UPI) plan, switches it to card billing
      --from-balance                   Pay the plan now from your deposited balance instead of printing a Checkout link (needs --plan; free credit can't pay a plan)
  -h, --help                           help for subscribe
      --plan deeprelay billing plans   Plan to subscribe to, by key: flat (Base, the default) or plus (deeprelay billing plans lists them)
      --success-url string             Where Stripe returns after a completed payment; must be on the dashboard site (defaults to the server's configured URL)
      --upi                            Pay in rupees with UPI AutoPay (India): priced at today's rate, each renewal at that day's rate. On a dollar plan, switches it to UPI billing

Options inherited from parent commands

      --api-base string   API base URL (override with DEEPRELAY_API_BASE env) (default "https://api.deeprelay.ai/v1")
      --debug             Enable debug logging to stderr
      --no-preflight      Skip the plan/credit check before inference requests (override with DEEPRELAY_NO_PREFLIGHT env)
  -o, --output string     Output format: table|json (default table on TTY, json otherwise) (default "table")