Learn about Stigg's integration with Stripe Billing
Stripe is the fastest way for your business to bill customers with subscriptions or invoices, and accept recurring payments globally.
Stigg's native integration with Stripe enables:
- Automatic propagation of changes from the Stigg platform to Stripe, including: changes to the product catalog (product, plans and add-ons, coupons), customers, subscriptions and their usage.
- Automatic propagation of changes from Stripe to Stigg, including: subscription cancellations in Stigg when they're cancelled in Stripe.
- Ability to leverage Stripe's hosted checkout page for customer checkout process, without needing to perform any additional integration with Stripe.
Stigg entities are mapped to Stripe entities as follows:
|Stigg Entity||Stripe Entity||Stripe Entity Name Format||Notes|
for example: Acme Basic Plan
|Every plan version is mapped to a dedicated Stripe product. When new plan versions are published, the Stripe products of old version are archived in Stripe, meaning that new subscriptions to the old plan version cannot be created.|
for example: Acme 10 Seats Add-on
|Every add-on version is mapped to a dedicated Stripe product. When new add-on versions are published, the Stripe products of old version are archived in Stripe, meaning that new subscriptions to the old add-on version cannot be created.|
|Coupon||Coupon||When a coupon is archived in Stigg, it's deleted in Stripe; therefore, the coupon cannot be applied to new customers. Existing customers that the coupon is applied to are not affected.|
Entities that are not synced to Stripe
|Entity||Not synced to Stripe when...|
|Customer||Customer doesn't have any subscription|
|Customer only has subscriptions to free plans|
|Customer only has trial subscriptions|
|Customer only has subscriptions to plans with a custom price|
|Customer doesn't have a payment method define in the billing solution|
|Syncing of customers is disabled in the environment|
|Subscription||Subscription is for a free plan|
|Subscription is for a trial plan|
|Subscription is for a plan with a custom price|
|Syncing of subscriptions is disabled in the environment|
Syncing customer usage to Stripe
When customers are subscribed to plans with usage-based pricing, the customer usage that's reported to Stigg is synced to Stripe once every hour.
Adding the Stripe integration in Stigg
In the Stigg Console, under the Settings > Integrations > Apps section, select the Stripe connector.
If you're setting up the integration for development or testing purposes, toggle "Use Stripe test account" on.
Click "Connect with Stripe".
You'll be redirected to Stripe in order to complete the integration process.
In the opened screen click "Connect", and follow the instructions.
Once all of the integration steps on the Stripe side are completed, you'll be redirected back to Stigg.
Indication for synced entities
Entities that are synced from Stigg to Stripe have a clickable "billing ID" property with a Stripe logo next to it and indication of their sync status (successful, failed, will not be synced).
When attempting to add or edit entities that are synced to Stripe, there will be an indication that the change will also be reflected Stripe.
Accessing Stripe entities from Stigg
In the Stigg Cloud Console, clicking on the link of the "billing ID" property will open the relevant entity in Stripe.
Accessing Stigg entities from Stripe
In Stripe, under the "Metadata" section of the relevant entity, click on the link that appears under the "stiggEntityUrl" field.
Integration with Stripe's Billing Portal
When Stigg is integrated with Stripe and using Stigg's Customer Portal widget, customers can update their billing information and view previous invoices directly from Stripe's Billing Portal.
To ensure that the functionality of Stigg's Customer Portal doesn't collide with that of Stripe's Billing Portal, it's recommended to configure Stripe's Billing Portal as follows:
- Invoice history - enabled
- Customer information - enabled
- Email address - unchecked
- Billing address - checked
- Phone number - checked
- Payment methods
- Payment method - enabled
- Cancel subscriptions - disabled
- Pause subscriptions - disabled
- Switch plans - disabled
- Update quantities - disabled
Removing the integration from Stigg
To remove the integration, click on the dotted menu icon and select the "Remove" action.
Confirm the action by clicking on the "Remove" button in the opened modal.
Updated 2 months ago