Skip to main content
You can create and test extensions before connecting Stripe, but an extension cannot accept payments from users until you connect a Stripe account and assign it to the extension.

​
Connect your account

1

Go to the dashboard

Visit the Dashboard.
2

Add a Stripe account

Click Add Stripe account. You’ll be redirected to Stripe to select the account you want to connect.
3

Authorize the account

Sign in to the Stripe account you want to use and approve access. Stripe controls account eligibility and may require additional business or identity information. Once approved, you’ll be redirected to the dashboard.
4

Assign the account

Open an extension and select its Stripe account. You can connect multiple Stripe accounts and assign the same account to more than one extension. The assignment is locked after the first user subscribes to the extension.
5

Activate the customer portal

Go to your Stripe Billing Portal settings and activate the customer portal link (if not already active). This allows your extension users to manage their own subscriptions directly.
The dashboard shows these readiness indicators for each account:
  • Stripe Connected - your account is linked
  • Details Submitted - Stripe has your business information
  • Charges Enabled - you can accept payments

​
Configure failed payment handling

Stripe decides what happens after it retries failed subscription payments. Configure this before launch so users do not keep access longer than you intend. crxbase treats past_due subscriptions as paid only until the subscription’s current billing period ends. This follows Stripe’s recommendation to give customers time to fix a failed renewal payment. If your Stripe settings leave a subscription as past_due after all retries fail, getUser() returns paid: false after period_end.
crxbase recommends canceling the subscription after Stripe finishes retrying failed payments. This gives users a clear path to subscribe again and avoids long-running past_due subscriptions.
1

Open automatic collection settings

Go to Stripe automatic collection settings.
2

Review failed payment methods

In Manage failed payments, review the payment methods Stripe will retry. For card payments, click Manage if you need to change retry behavior or customer communication settings.
3

Set Subscription status

Choose what Stripe should do with a subscription If all retries for a payment fail. crxbase recommends cancel the subscription. You can choose to mark it unpaid or leave it past_due instead, but decide this intentionally based on how you want customers to recover access.
4

Set Invoice status

Choose what Stripe should do with an invoice If all retries for a payment fail. A common setting is mark the invoice as uncollectible, which keeps your records clear when payment recovery has failed.
5

Save your changes

Click Save in Stripe. Users with failed payments can still open the customer portal from your extension to update their payment method.
You can leave rest of the settings at their defaults.

​
Platform fee

crxbase charges a 5% platform fee on each transaction. This is automatically deducted by Stripe during payment processing - you receive the remainder directly in your Stripe account. Stripe processing fees, bank fees, taxes, VAT/GST, refunds, disputes, and chargebacks are separate from the crxbase platform fee. You are responsible for configuring tax collection, receipts, and customer-facing tax disclosures for your own products in Stripe.

​
Disconnecting

You can disconnect a Stripe account from the dashboard at any time. The confirmation dialog identifies the extensions currently assigned to it. Once you disconnect:
  • Existing Stripe subscriptions continue in Stripe
  • crxbase retains extension assignments, billing history, and stored Stripe references
  • Billing actions and synchronization stop until the same account is reconnected
  • Reconnecting refreshes only subscriptions already tracked by crxbase; it does not import unrelated subscriptions
Subscribers may continue to be charged by Stripe while the account is disconnected, but crxbase cannot synchronize changes or manage billing until you reconnect it.