Billing
Billing should never be a blocker to using Shorebird’s tools. Customers are met where they are, whether that means flexible payment methods, enterprise invoicing, or custom terms. If you’re building with Flutter, building with Shorebird should be just as easy.
Payment provider - Stripe
Section titled “Payment provider - Stripe”Shorebird uses Stripe for all billing and payments, and accepts any payment method that Stripe supports. You can view more details in Stripe’s Supported Payment Methods documentation.
Billing email
Section titled “Billing email”Invoices are sent at the end of each billing period by Stripe. Since they are sent by Stripe, they do not use your Shorebird account email, but rather the email associated with your Stripe account. In most cases, these emails are the same, but you can change them to be different.
If you’d like invoices sent to a different email address than the one you use to log in, change it in Stripe’s billing portal:
- In the Shorebird console, open Account from your account menu, then click Manage plan.
- On the Plan page, find the Payment card and click Manage billing information.
This opens Stripe’s billing portal, where you can update the email invoices are sent to, along with your payment method and billing address.
On an Enterprise plan, the Plan page has no Payment card; contact contact@shorebird.dev to change where invoices go.
Invoices and receipts
Section titled “Invoices and receipts”Your recent invoices are on the Plan page (Account, then Manage plan), in the Invoices card. Each row shows the invoice date, its status and its amount, and whether it’s for your Plan or for Overages. On a monthly plan, overages are on the plan invoice, so only annual plans have Overages invoices. The card leaves out invoices for $0.
To download an invoice or receipt:
- Click the invoice’s row. Stripe’s invoice page opens in a new tab.
- Click Download invoice, or Download receipt for a paid invoice.
For older invoices, or a row that doesn’t open, click View all invoices at the bottom of the card. This opens your full invoice history in Stripe.
On a Pro or Business plan, which charges your saved payment method automatically, an unpaid invoice’s row opens the page to update your payment method instead, and View all invoices is hidden until it’s paid. To get a copy of that invoice, use the link in Stripe’s invoice email, or contact contact@shorebird.dev.
If a row shows Confirm payment, your bank needs you to approve the payment. Click the row and approve it on Stripe’s invoice page.
On an Enterprise plan, once billing is set up for your enterprise, its invoices are on the Billing tab in the enterprise console instead. Each invoice there has a View or Pay link to Stripe’s invoice page and a PDF link. Owners and Billing managers can see the tab; see Enterprise Roles. Until billing is set up there, the tab says so, and invoices stay on the organization owner’s Plan page.
Once billing is set up, the enterprise Billing tab also shows your contract. The Contract card has its plan, how it’s billed, the current period and when it renews or ends, and the included patch installs used this period, with any overage. To change your legal name, payment method, invoice email, billing address or tax ID, email either address on the card. Organizations covered lists each organization your enterprise’s bill covers, with its owner, apps and patch installs this period. The Contracts card, shown whether or not billing is set up, lists your signed contracts, each with a download link.
Available plans
Section titled “Available plans”Flexible options are provided to accommodate every team and product, whether it’s an indie/hobby project or a globally launched enterprise application. See the pricing page for more information.
Most customers can easily get started with the self-service Pro and Business plans; see Plans & Upgrading for how to upgrade, switch, or cancel. If you need invoice billing, tax support, alternative payment methods, custom contract/procurement process, or volume pricing beyond the Business plan’s 1,000,000 included patch installs a month, please reach out regarding an Enterprise Plan.
Organizations & billing
Section titled “Organizations & billing”Billing is tied to the organization’s owner’s account, not to individual organizations. When you create an organization, it inherits its plan from your subscription. This means a single account can own multiple organizations and each organization will share the owner’s plan.
For more information on how organizations and ownership work, see Organizations. For what happens to the plan when an organization changes owner, see Account access and ownership.
How Shorebird bills
Section titled “How Shorebird bills”Shorebird charges based on successful patch installs. A “patch install” is a successful update applied on a customer’s device.
- Patch installs are only billed upon successful download and application of a patch.
- Users always skip to the latest patch. If you send two patches before a user updates, you’re only billed for one patch install for that user.
- You are not charged if the user never launches the patched application.
If you own the plan, you can see your current patch installs on the Plan page (Account, then Manage plan). Every member of an organization finds them in the Usage card on the General tab of the organization’s settings, and in the organization switcher, which shows how many installs the current organization’s plan has used this period. On Enterprise, Owners and Billing managers also see the plan’s usage on the Billing tab of the enterprise console. These numbers are updated hourly.
To see installs in past billing periods, click Usage history on the Plan page’s usage card or the organization’s Usage card. On a plan that offers overages, the Plan page’s usage card also has Overage history in its overages section, which lists the overage installs and amount billed each month.
Overage billing
Section titled “Overage billing”When your patch installs pass what your plan includes, overages let you keep shipping patches, billed per install. They’re available on Pro and Business plans, monthly or annual, and they’re off until you turn them on. On Enterprise, overage terms are set in your contract. With overages off, patches stop installing once you’ve used your plan’s included installs, until the next billing period; see Patches stopped installing on devices.
To turn overages on or off, or to cap what they can cost:
- Open the Plan page (Account, then Manage plan).
- Under your patch install usage, click Configure overages.
- Check Overages enabled. To stop patches once overages reach a set amount, also check Overage spending cap and enter the cap in dollars or installs.
- Save the change.
Configure overages is hidden while a payment is past due.
Shorebird emails the plan’s owner and every member of its organizations when installs reach 80% of your limit, and again when they reach it. On an Enterprise plan, the enterprise’s Owners and Billing managers get them too. The limit is your plan’s included installs, plus your spending cap if you set one. With overages on and no cap, there’s no limit, so these emails aren’t sent.
Each recipient can turn these emails off with the Usage alerts switch under Email notifications on their Account page, from the CLI, or with the unsubscribe link in the email; see Turn email notifications on or off.
Overages are billed monthly, on the invoice after the month they were used. On an annual plan, they’re a separate monthly invoice from your plan’s.
Example
Section titled “Example”On a monthly Pro plan ($20 a month, including 50,000 patch installs) with overages on, if you use 100,000 patch installs every month:
- You’re billed $20 when you subscribe.
- Each month after that, you’re billed $40: $20 for the new month, plus $20 for the previous month’s 50,000 overage installs.
On an annual plan, your included installs are counted over the whole year. With overages on, a spending cap, if you set one, limits each month’s overages.