Activate customer profiles on Stripe

Learn how to synchronize customer profiles with Stripe for activation.

View as Markdown

Krenalis lets you easily sync customer profiles from your data warehouse to Stripe, keeping them up to date without manual imports or scripts. Once connected, Krenalis automatically exports and updates records based on your defined filters and transformations, ensuring your Stripe data always reflects the latest customer information.

How it works

  1. Choose where to sync. Select the Stripe customers to keep up to date.
  2. Select your audience. Choose which customer profiles to include.
  3. Map the data. Match each property from your Customer Model to Stripe fields using Visual Mapping, JavaScript, or Python.
  4. Set the schedule. Choose how often Krenalis synchronizes profiles.
  5. Keep it fresh. Krenalis automatically updates your Stripe customers, adding or updating customers when new profiles appear.

The result: your Stripe customers always mirror your customer data, ensuring accurate and up-to-date records for payments and customer management.

Steps

Follow these steps to connect Stripe and set up profile exports.

1. Create a Stripe API key

  1. Log in to your Stripe account.
  2. Go to Developers → API keys.
  3. Click Create restricted key.
  4. If asked How will you use this API key?, select Building your own integration.
  5. Enter a name (e.g., Krenalis data destination).
  6. In the Customers row, enable both Read and Write permissions.
  7. Click Create key, then copy the token shown for the new key.

2. Connect Krenalis with Stripe

  1. Go to the Destinations page of your Krenalis workspace.
  2. Click on Add a new destination ⊕ and click on the Stripe card.
  3. Click on Add destination....
  4. Paste the previously copied API key and click Add.

3. Add a pipeline to export profiles

On the connection page, click on Add pipeline... to define how profiles should be exported to Stripe.

Add pipeline

Each pipeline tells Krenalis which data to send and how to structure it in Stripe. You can define multiple pipelines per destination to manage different datasets.

4. Filter profiles

If you don't want to send all profiles to Stripe, use filters to select which profiles to sync. Only profiles that match the filter conditions will be synced. If no filters are set, all profiles will be exported. For more information on how to use filters, see the Filters documentation.

Filter

5. Set how customers sync to Stripe

The Export settings section tells Krenalis how to recognize your customers and what pipelines to take to keep Stripe perfectly in sync with your latest customer data — automatically and without manual updates.

Export settings

  • Choose matching fields
    Select one property from your Krenalis data and one from Stripe to compare — usually something unique like an email address or customer ID. Krenalis uses these fields to check if a contact already exists in Stripe. What happens next depends on the sync rules you choose below.

  • Decide how handle each contact You can choose to add new customers when they don't exist in Stripe, update existing ones when their information changes, or do both.

  • Manage duplicate customers
    If more than one Krenalis profile shares the same matching value, you can define how Krenalis should handle them. These settings help keep your data clean and avoid unwanted duplicates in your audience.

6. Transformation

Use the Transformation section to decide how customer data is written to Stripe customers. You can visually map fields from the Customer Model to Stripe fields, or use JavaScript and Python for more advanced logic (for example, formatting dates or combining multiple properties).

Filter

7. Save your changes

When everything looks good, click Add (or Save if you're editing an existing pipeline).

To export another set of profiles to the same Stripe account, repeat the process starting with the Add a pipeline to export profiles step.

Pipelines

Once saved, the new pipeline appears in the pipelines list for Stripe. From here, you can monitor imports, adjust filters, and manage transformations. Each pipeline defines how and when profiles flow from your warehouse to Stripe.

With a single Stripe connection, you can create multiple export pipelines to sync different data segments within the same account.

Pipeline to export profiles
Column Description
Pipeline Name and description of the pipeline.
Filters Conditions used to select which profiles are exported. If not set, all profiles are included.
Enable Switch to activate or deactivate the pipeline. When disabled, the pipeline will not run, even if a schedule is defined.
Run now Run the export immediately, one time only. Available only when the pipeline is enabled.
Schedule Frequency of automatic exports. You can also run the export manually at any time.
Manage Edit settings such as filter and transformation.
⋮ (More) Additional options, such as deleting the pipeline.