Payments: Stripe

Use this guide to:

• Update an expiring Stripe connection
• Create a new Stripe connection
• Troubleshoot a Stripe connection

Update an expiring Stripe connection

In Kartra:

1. Go to Settings > Integrations
   • 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.
   
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.

Reconnect the Stripe account

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.
     
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.

Create a new Stripe connection

In Kartra:

1. Go to Settings > Integrations
2. Click + Integration in the top right
3. In the Provider window, select Stripe then click Next.
4. 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

In Stripe:

1. Use your Stripe credentials to log in
2. Select the account you want to connect with Kartra
   
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

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 the keys do not match, check each of your Stripe accounts until you find the matching key

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.

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.

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.