Stripe is a payment processing service that provides secure credit card processing online. Start a new integration in Kartra to connect with Stripe and select or create an account.

Use this guide to:


Update an expiring Stripe connection

If your Stripe connection was created before July 11, 2024, it may need to be reauthenticated. If you are due for reauthentication, you will see an alert banner in your account and a red status indicator in your Integrations page if an update is needed.

Expiring Stripe connections must be updated by August 5, 2024. If reauthentication is not completed, all checkouts and recurring payment subscriptions using the expired connections will stop working on that date.

Before you begin: We recommend that you log in to Stripe in a separate browser tab before starting the update in Kartra. This will eliminate the login step from the integration update and make the process a little smoother.

In Kartra:

  1. Go to Integrations
    1. Tip: Use the drop-down menu in the top right to filter by Payment integrations or search for Stripe.
  2. Locate all Stripe integration tiles with a red status bubble indicating that an update is needed.
    Stripe integration needs an update
  3. Click the three dots to open the menu on each Stripe tile and select Edit.
  4. In the Edit payment gateway window, click Connect with Stripe.

Take note of the Publishable key listed in the integration screen. This can be used to identify the correct Stripe account needed for this update if you have more than one.

Reconnect the Stripe account

A single Stripe profile can be associated with multiple Stripe payment accounts.

In Stripe:

  1. Use your Stripe credentials to log in (if you are already logged in, this is not required again) 
  2. Select the account linked to this integration
    • Important: You must connect the same account that was previously used for this integration to preserve the existing billing configurations in your account.

      Connect a Stripe account
  3. Click Connect to reauthenticate the connection and go back to Kartra
  4. A success message confirms the integration is complete! It is no longer necessary to enter API keys or configure a webhook.

If you have more than one Stripe account and are not sure which account goes with each integration, compare the Publishable key shown in Kartra with the Publishable key for each of your Stripe accounts. See troubleshooting at the end of this guide for more details.

To update more Stripe connections, repeat the process above for each one.

When reauthentication is complete

  • Subscription billing associated with the original integration is automatically updated and will continue to process as normal.
  • Payment gateway settings in your products will retain the updated integration with no further configuration. Your checkouts will continue to process payments as normal.
  • The Stripe Account ID and Name are displayed anywhere you would have previously seen the API keys as an identifier for the integration. For example, in the product payment gateway selection, the Stripe integration tile, and the Stripe integration details.

    Successful Stripe reconnection

Create a new Stripe connection

In Kartra:

  1. Go to Integrations
    • Tip: Use the drop-down menu in the top right to filter by Payment integrations or search for Stripe.
  2. Click the three dots to open the menu on any Stripe tile and select + New integration
    • A green checkmark on the integration tile means at least one integration is already active for the service. You can add more than one.
  3. In the New payment gateway window, click Connect with Stripe. A new window opens on the Stripe website, where you can connect an account.

Connect a Stripe account

A single Stripe profile can be associated with multiple Stripe payment accounts.

In Stripe:

  1. Use your Stripe credentials to log in
  2. Select the account you want to connect with Kartra

    Connect a Stripe account
  3. Click Connect to authorize the connection and go back to Kartra

To link more Stripe payment accounts to Kartra, create a new integration for each one. Use the process above for each connection.


Troubleshoot a Stripe connection

Error: “Stripe account incorrect” in Kartra integration screen

This error may appear if you are trying to update an expiring Stripe connection. To complete the update, you must click Connect with Stripe and select the same account that was previously linked using API keys. If the selected account does not match, you will see this error.

Check the Stripe account’s publishable key to find the correct match:

  1. In Kartra, open the Stripe integration for editing. The original publishable key for the Stripe account appears in the bottom right.
  2. In Stripe, open any of your accounts and go to Developers > API keys
  3. Look for Publishable key
  4. Compare the publishable key token in Stripe with the publishable key entry in the Kartra integration window
    • If the keys match, this is the account you must select to update your Stripe connection in Kartra
    • If they keys do not match, check each of your Stripe accounts until you find the matching key

“Ineligible accounts” in Stripe selection screen

Your Stripe accounts may be listed as ineligible on the account selection page. An account is ineligible if it is already connected to a different platform.

  • To make an account eligible for connection with Kartra, disconnect it from the existing platform and then begin this guide again. Stripe accounts can only be connected to one point-of-sale system at a time.

Error: “The user denied your request” in Kartra integration screen

This error appears if you click Connect with Stripe and then click “Return to Kartra” without completing the connection.

  • Click Connect with Stripe again to restart the update.

Error: “This Stripe account has already been integrated” in Kartra integration screen

This error appears if the Stripe account you selected after clicking Connect with Stripe has already been integrated with your Kartra account.

  • Click Connect with Stripe again to select a different account if needed.
  • To confirm which account is connected in Kartra, check Settings > Business > Account details in your Stripe account(s) to compare the Account name and ID (shown in the next image) with the details shown on each unique integration in your Kartra account.

    Account name and ID are found in your Stripe account