Stripe Integration
This page explains how to integrate Stripe with the SaaS Development Console to streamline billing and invoice management.
Information such as pricing plans and tax rates configured in the SaaSus Platform will be automatically synced to Stripe and used in the invoicing process.
If you do not use Stripe, this configuration is not required.
Registering the Stripe Secret Key
To enable Stripe integration, register your Stripe secret key in the SaaSus Platform.
- Go to the External Integrations menu from the SaaS Development Console
- Enter your Stripe Secret Key
- Click Save
Once completed, future pricing plan and tax rate configurations will automatically be sent to Stripe.
Tax Rate Mapping to Stripe
Tax rates configured in the SaaS Development Console will be reflected in Stripe as follows:
| Stripe Column | SaaS Development Console Field | Description |
|---|---|---|
| - | Tax Rate Name | Internal identifier (must be unique) |
| Type | Display Name | Displayed on Stripe invoices (if integrated) |
| Description | Description | Human-readable label for the tax rate |
| Rate (%) | Percentage | Numeric value of the tax rate |
| Region | Country | Country where the tax applies |
| Inclusive/Exclusive | Inclusive/Exclusive | Indicates whether the tax is included in the amount or not |
Example: Invoices Issued with Stripe
Based on the configured tax settings, Stripe will generate invoices accordingly — here are examples for inclusive, exclusive, and no tax cases.
Invoice with Inclusive Tax
Invoice View
PDF Version
Invoice with Exclusive Tax
Invoice View
PDF Version
Invoice without Tax Settings
Invoice View
PDF Version
Note on Automatic Cancellation in the Test Environment
In the Stripe test environment, by specification, subscriptions are automatically canceled 90 days after creation. Subscriptions created via SaaSus Platform are also subject to this, so during testing only the Stripe side may become canceled, causing a state inconsistency between SaaSus Platform and Stripe.
If you need to continue testing over a long period, exclude the target subscription from automatic cancellation.
How to exclude
Open the target subscription in the Stripe dashboard, and from the "..." menu to the right of "Update subscription", select "Exclude from auto-cancellation".
This is behavior specific to the Stripe test environment and does not occur in the production environment. The names and locations of setting items may change due to Stripe specification changes, so please also refer to the latest Stripe documentation.