When connecting Stripe to Kana, we will import in all your Stripe subscriptions and ensure these are synced between the two platforms when changes take place.

In order to achieve this, however, the following needs to be done:

1. Stripe prices must be mapped to Kana packages

2. Stripe customers must be linked to (or created as) users in Kana

This is because we need to understand which features/packages a user has subscribed to via Stripe, and associate this subscription to a user in Kana.

​

Mapping Stripe Prices to Kana

​

What do I map from and to?

In Stripe, customers will have a subscription which can contain multiple subscription items. Each subscription item will have a set quantity and a price. A price is associated with one product.

Kana looks at both the Stripe price and the associated product as one. Together these make up the quantity, price, billing structure, and the actual product itself. This is what will be mapped to the relevant Kana object.

How you have setup your Stripe prices (with the associated product) in Kana will determine how and what they will be mapped to in Kana.

​

Prices/Products as Packages

This works on the assumption that you have setup your Stripe prices (and associated product) to be mapped to an overall package as opposed to the features within that package.

Therefore, Stripe objects would map to Kana objects like so:

​

Prices/Products as Features

This works on the assumption that you have setup your Stripe prices (and associated product) to be mapped to features, meaning a Stripe subscription represents an overall package with each subscription item being a feature within that package.

Therefore, Stripe objects would map to Kana objects like so:

​

How do I map?

This is done during the initial importation flow, and then can be done for newly created prices/products we’ve attempted to sync unsuccessfully by going to Integration > Stripe.

You can see more on mapping during importation in the Import from Stripe guide.

Import Subscriptions from Stripe

​

Mapping Stripe Customers to Kana

​

Where do you map from and to?

Each Stripe subscription is associated to a Stripe customer. This Stripe customer corresponds to a Kana user.

We map the following fields from Stripe customers to Kana users:

​

Identifiers

Stripe customers only have an email field as opposed to a unique externally provided identifier. Therefore, we have to use the email to match and create Stripe users via.

This means that the id given to a user in Kana if they’re:

• New users created from Stripe importation or sync - will have their email as their id.

• Existing users created before Stripe importation - will have been given an id by you previously. This may be a user’s email but not necessarily.

​

How do I map?

This is done automatically.For any imported or incoming Stripe subscription, we always look to see if the related Stripe customer matches to an existing Kana user. We look at both the billingId and the email to achieve this. If they do, we associate the subscription to that existing user. If they don’t, we create a new user and associate that subscription to the new user.

​

What’s next?

You should not have an understanding of what and how your Stripe prices and customers are mapped (or should be mapped) to Kana. This means you can now import in your existing subscriptions and ensure subsequent syncing of subscriptions works.

Import Subscriptions from Stripe