BitelioBitelio

Billing

Find your project's billing provider, review usage and manage spending limits.

Open Settings → Billing in the project you want to manage. Billing belongs to the project, so two independent businesses in your Bitelio account can have different billing providers.

Projects connected to Shopify

A project connected to Shopify uses Shopify for plans and approved charges, whether you created it during installation or linked an existing Bitelio project. This also applies when you open that project on the Bitelio website.

Use Manage plan in Shopify when the billing screen makes it available. Shopify shows the applicable price, included usage, usage rates and any trial before approval. Manage that subscription and its invoices through Shopify; do not take out a separate Bitelio subscription through Stripe for the same project.

If the project has an existing subscription or a connection that needs review, the screen may ask you to contact support instead of opening another checkout. Complete that review before choosing a new plan. Connecting a project is not an automatic cancellation or transfer of its earlier subscription.

Disconnecting the store inside Bitelio does not cancel the Shopify subscription or make direct billing available. Manage cancellation through Shopify. Usage incurred before cancellation may still be billed afterward. Independent projects without a Shopify connection can continue to use direct Bitelio billing.

For installation and linking steps, see Connect Shopify.

Projects billed directly by Bitelio

Independent projects without Shopify use direct billing through Stripe. Settings → Billing provides their available plans, payment details, billing portal and invoice history. These actions require billing management permission.

Check the price, currency, included volume and overage conditions on the confirmation screen before subscribing. Plan benefits and AI allowances are shown in the project; a paid plan does not remove domain, consent or sending-readiness requirements.

A payment failure can prevent sending. Review the project's billing status and outstanding payment action rather than starting an unrelated subscription.

Email usage

The monthly email meter includes outgoing and incoming email:

SourceUsage
Transactional sends (/v1/send)1 credit per recipient
Campaigns1 credit per recipient
Workflow SEND_EMAIL steps1 credit per send
Incoming email1 credit per received email
Email with attachments2 credits per email

Other channels have their own requirements and costs; an email allowance does not mean unlimited WhatsApp or mobile-provider delivery. The program's estimated message and order costs are for profitability analysis, not a price or authorization to charge.

Limits and blocked sending

Under Settings → Billing → Limits, review the overall spending limit and any category limits for transactional email, campaigns, workflows or incoming email. A paid plan can support overage under its terms, but an exhausted limit, an unapproved Shopify charge allowance or an unresolved billing status can still block sending.

When a billing limit is reached, affected outgoing API operations can return 402 Payment Required with BILLING_LIMIT_EXCEEDED. Resolve the indicated limit or wait for its reset; do not blindly retry. A blocked incoming message is not queued for later delivery. Review the current period and reset shown in the billing screen.

If you upgraded but sending is still blocked, check that you changed the correct project, the change is reflected in its billing status and no separate spending limit remains. A plan change alone also does not enable a restricted second-purchase rollout.

API reference

These authenticated project endpoints require the relevant billing permissions:

  • GET /users/@me/projects/:id/billing-access — effective billing provider, management action and any review requirement.
  • GET /users/@me/projects/:id/billing-consumption — current-period usage by category.
  • GET /users/@me/projects/:id/billing-limits — category limits.
  • PUT /users/@me/projects/:id/billing-limits — update category limits.
  • GET /users/@me/projects/:id/billing-invoices — direct-billing invoices only; unavailable for Shopify billing.
  • POST /users/@me/projects/:id/billing-portal and POST /users/@me/projects/:id/checkout — direct Stripe billing only. They are not alternatives for a Shopify-connected project.

For better use of your allowance, see list hygiene and idempotency.