Billing for people and workspaces, add-ons, Stripe Tax, and magic links bound to one browser
Plans for people and workspaces, add-ons, Stripe Tax and tiered prices; magic links bound to one browser; Markdown for agents and Standard Webhooks headers.
Added
17- BillingPlans for people as well as workspaces. A pricing group can sell to a person, who pays on their own card and their own Stripe customer for what is theirs, such as their API keys or the agents they connect, while a workspace plan goes on covering the workspace. Every check says whose plan it reads, and neither plan lifts the other.
- BillingSomeone else can pay for a workspace: a person, or another workspace they manage billing for, pays on their own Stripe customer, so one card covers every project while each workspace keeps its own plan. A workspace plan can also give its owner or every member something on their own account, which is how a family or group plan works.
- BillingAdd-ons on top of a plan, in four shapes: a one-time unlock that lasts a set number of days, a lifetime unlock, a consumable pack of units that counts down as it is used, and recurring units billed with the plan. Your gates read them through the same entitlement check as the plan, and you refund a purchase from the console.
- BillingBehaviour change: a trial is offered once per person by default, where it was once per workspace: someone who has had one, in any workspace, is not offered another, and both the workspace owner and the person checking out count. A plan version can choose once per person per plan, or once per workspace, instead.
- BillingPromotion codes. Make coupons and codes under Billing > Subscriptions > Coupons, and customers use them from a link with ?promo=, in the plan picker, on a plan change or on a credit pack, with the code checked before anyone pays.
- BillingTax through Stripe Tax, on your own Stripe account and switched on under Billing > Credentials. Checkout asks for a billing address and takes a business's tax ID, and invoices and the payment.succeeded event carry the subtotal, discount and tax.
- BillingGraduated and volume tiers for overage and seat prices, and overage reported to Stripe through Billing Meters.
- CreditsReserve credits before a job runs and settle at what it actually cost, so a long agent run never finds the balance gone halfway through. A workspace can top up on its saved card when its balance falls under a threshold you set, and a person can hold credits of their own.
- BillingCheckout can open inside your app instead of on Stripe's page, a customer sees what a plan change will cost before confirming it, and cancelling asks for a reason and can offer a coupon or a pause first. Customers can pause a subscription themselves when you allow it. The screens for these are in @buildbase/sdk 1.0.0.
- BillingA notice before a card expires: when the card a subscription is charged on expires within 30 days, the workspace owner gets an email and a push, and you get the payment.card_expiring webhook.
- WebhooksNew events: payment.stripe_events_failed when Stripe events still fail after the hourly retry, subscription.stripe_out_of_sync when the daily check finds subscriptions it cannot match with Stripe, and payer.subject_added and payer.subject_removed when someone starts or stops paying for a workspace.
- SDKuseEntitlement, useLimit and WhenEntitled answer for a workspace or for the signed-in person's own plan (from @buildbase/sdk 1.0.0).
- WebsiteEvery post and changelog page on buildbase.app has a Markdown twin: add .md to the URL. /llms-full.txt holds every published post and the changelog in one file, beside /llms.txt.
- WebsiteFiles for AI agents on buildbase.app: /AGENTS.md says what the site is and where to look, /auth.md which credential to use, /feedback.md where to report a problem, and /.well-known/api-catalog lists our APIs in the RFC 9727 format.
- WebhooksEvery delivery also carries the Standard Webhooks headers, webhook-id, webhook-timestamp and webhook-signature, so a receiver can verify it with any Standard Webhooks library. The x-buildbase headers you verify today are unchanged.
- ConsoleSign a terminal in to the console with a device code: npx @buildbase/sdk login prints a short code, you approve it on the console's device page while signed in, and the token is saved on that machine. The command comes with @buildbase/sdk 1.0.0.
- AgentsMCP servers built with the SDK speak protocol 2026-07-28 beside 2025-11-25, publish a server card (SEP-2127) and an AI Catalog, and let each client narrow the tools with ?toolsets=, ?readonly= and ?omit_tools=. npx @buildbase/sdk agent doctor checks a server the way AI clients connect to it, agent install makes install links for each client, and agent listing drafts a directory listing (from @buildbase/sdk 1.0.0).
Improved
5- AuthenticationA magic link opened in a browser other than the one that asked for it cannot sign in. This is on for every organization, new and existing; if your users ask for a link on one device and open the email on another, turn off Require the same browser in the magic link method's settings, or send a 6-digit code instead.
- TrackingThe bb_attr attribution cookie waits for marketing consent: nothing is written before the visitor agrees, and refusing deletes it. An app that captures attribution without the tracking provider uses setAttributionConsent and getAttributionConsent (from @buildbase/sdk 1.0.0).
- AuthenticationA refresh token given to an Application (first-party) client now carries a 180-day lifetime from when it was issued, after which it is refused with 400 invalid_grant and the person signs in again; refreshing does not extend it. For this release, older tokens issued without a lifetime, or signed with a secret since replaced, are still accepted and logged so you can be told first. Agent clients are unchanged.
- AgentsThe consent screen and the device approval page list everything an agent gets: that it acts as the person, which of their details your app sees, how long it stays connected and any permission it asked for by name.
- ConsoleDeleting a user refuses the organization owner, an owner or admin deleted by someone who is neither, the last owner or admin, and your own account, each with its reason.
Fixed
5- BillingA refund or a dispute is recorded once, even when Stripe sends its event again or a second partial refund follows, and a dispute you win gives back the credits or the unlock it took, without anyone restoring it by hand. Add charge.dispute.closed to your Stripe webhook endpoint for this.
- ConsoleInvitations to your console team: accepts sent at the same time add one membership, a revoke or reject racing an accept leaves nobody in, and removing someone removes every membership they had. After an ownership transfer, the outgoing owner loses owner-only access at once instead of keeping it until their token expired.
- BillingThe Plan Canceled email goes out when a cancellation is scheduled, while its words are true, instead of after access has ended. Billing emails about a person's own plan no longer call it a workspace, and a $0 invoice no longer sends a Payment received email.
- BillingPrices in currencies without two decimals show and save correctly: in the console's plan and credit pack editors and lists, the pricing group preview, the overage note on the pricing page and the affiliate calculator. A yen price of 5000 reads ¥5,000, not ¥50.00, and three-decimal currencies such as the Kuwaiti dinar show three.
- BillingA workspace whose trial ended, or whose payment lapsed or is paused, reads 0 available on every quota in the SDK, the API and the MCP tools, matching what it can use; before, some reads still showed the plan's allowance.