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 September 16, 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:
- Go to Integrations
- Tip: Use the drop-down menu in the top right to filter by Payment integrations or search for Stripe.
- Locate all Stripe integration tiles with a red status bubble indicating that an update is needed.
- Click the three dots to open the menu on each Stripe tile and select Edit.
- 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:
- Use your Stripe credentials to log in (if you are already logged in, this is not required again)
- 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.
- Important: You must connect the same account that was previously used for this integration to preserve the existing billing configurations in your account.
- Click Connect to reauthenticate the connection and go back to Kartra
- 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.
Create a new Stripe connection
In Kartra:
- Go to Integrations
- Tip: Use the drop-down menu in the top right to filter by Payment integrations or search for Stripe.
- 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.
- 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:
- Use your Stripe credentials to log in
- Select the account you want to connect with Kartra
- 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: “Connection failed: Stripe account does not match” 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:
- In Kartra, open the Stripe integration for editing. The original publishable key for the Stripe account appears in the bottom right.
- In Stripe, open any of your accounts and go to Developers > API keys
- Look for Publishable key
- 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.
Need more help?
If you are not able to complete your Stripe integration using this guide, please reach out to our support team! You can submit a ticket from inside the help center.
Please include any screenshots that will help show the problem you're having and a description of any troubleshooting steps you have already tried.