How to Set Up Your Stripe API Keys With Spirit Sale

Overview

Spirit Sale integrates directly with Stripe to process payments. To connect your store, you’ll need your live publishable key and live secret key from Stripe.

Important Notes:

• Only standard live keys are supported. Restricted keys will not work with Spirit Sale.

• You must also enable Card Data Collection with a publishable key without using Stripe’s Pre-Built UI Elements in your Stripe dashboard for the integration to function correctly.
  

• Stripe must be enabled per store after adding your credentials.
  

• To update keys later, Stripe must first be disabled in all stores where it’s currently active.

Step 1: Log Into Stripe

1. Go to https://dashboard.stripe.com.

2. Sign in with your Stripe account credentials.

3. Confirm you are in Live mode, not Test mode.

Step 2: Find Your Existing Live API Keys

1. In the left menu, click Developers → API keys.

2. Under Standard keys, you’ll see:

   • Publishable key (pk_live_...)

   • Secret key (sk_live_...)

3. If the secret key is hidden, click Reveal live key.
   

Step 3: Generate New Keys (If Needed)

1. On the API keys page, click Create secret key.

2. Stripe generates a new publishable/secret key pair.

3. Copy both values immediately (the secret key is only shown once).

4. Enter these keys in Spirit Sale (see Step 5).

Restricted keys are not supported. Always use standard live keys.

Step 4: Enable Card Data Collection Without Stripe’s Pre-Built UI

Spirit Sale does not use Stripe Elements or Checkout — it uses direct API integration. To allow this:

1. In Stripe, go to Developers → Settings → Integration or visit https://dashboard.stripe.com/settings/integration while still signed into your Stripe account if you are unable to find the setting.  

2. Click Show advanced options.

3. Find the option: “Enable Card Data Collection with a publishable key without using Stripe’s Pre-Built UI Elements”.
   

4. Turn this setting ON.
   

5. If asked "Are you sure you want to enable all integrations?" click the Continue button. 

6. Save your changes.
   

This allows Spirit Sale to securely collect and tokenize card data using your publishable key, without requiring Stripe’s pre-built UI components.

Step 5: Add Stripe Keys to Spirit Sale

1. Log into your Spirit Sale Admin Dashboard.

2. Go to Settings → Payments → Stripe.

3. Enter your:

   • Secret key (sk_live_...)

   • Publishable key (pk_live_...)
     

4. Make sure the Active toggle is ON.

5. Save your changes by clicking the green Update button.
   

What does Auto Capture Mean?

Yes (Recommended) - Authorization and capture occur automatically when the payment is successful. You don’t need to manually capture payments later in the Stripe dashboard.

No - Authorization is placed on the customer’s card, but funds are not captured until you explicitly confirm. You do need to manually capture payments later in the Stripe dashboard.

Step 6: Enable Stripe for Each Store

Adding Stripe to your Spirit Sale account does not automatically enable it in every store. You must activate it individually for each storefront.

1. In the Spirit Sale Admin Dashboard, go to Store Fronts → Stores.

2. Select the store where you want to enable Stripe (or click the Edit button for a store).

3. Scroll down to the Store Details tab.

4. In the Payment Methods section, click Stripe.

   • The Stripe box will highlight in green when selected.

5. Click the green Update button in the top right corner of the screen to save.

Repeat this process for every store that should accept Stripe payments.

Step 7: Testing & Updating Keys

• You may use Stripe test keys (pk_test... and sk_test...) for testing transactions before going live.

• When switching between test keys and live keys, or when updating live keys:

  • First disable Stripe in all stores where it is currently enabled (uncheck Stripe under Store Fronts → Store → Payment Methods).

  • Once disabled, update your credentials in Settings → Payments → Stripe.

  • Re-enable Stripe in each store where it should be active.

This process prevents checkout disruptions and ensures all stores use the updated credentials consistently.

Step 8: Test Your Setup

1. Place an order in one of your enabled stores.

2. Confirm the card entry field appears at checkout.

3. Complete the order to verify that payments process successfully.

Troubleshooting

• Restricted keys entered → Replace with standard live keys (pk_live... and sk_live...).

• No card entry at checkout → Check the Card Data Collection Without Pre-Built UI toggle in Stripe.

• Stripe missing in checkout → Verify you’ve enabled Stripe under Store Fronts → Store → Payment Methods.

• Payments failing → Ensure publishable and secret keys are from the same Stripe account and are live keys.
  

• Unable to update keys → Disable Stripe in all active stores before updating credentials.

• Related Articles

• How to enable offline payments

  First, enable Offline Payment as a payment method, if not already enabled. From the Spirit Sale dashboard go to Setting --> Payment Methods. Click the Offline Payment box. Enable the Active toggle, then press Update. Now, to enable Offline payments ...

• Stripe Error - This integration surface is unsupported for publishable key tokenization

  With Stripe integration your customers may see the following error when attempting to checkout. There is a setting in your Stripe account that needs to be enabled for integration with Spirit Sale to work. 1.) While logged into Stripe visit ...

• Error Payment method is being using by a published or scheduled to be published store. Please remove it from the store and retry.

  Error: Payment method is being using by a published or scheduled to be published store. Please remove it from the store and retry. When attempt to update a payment method. First the payment method will need to be disabled on your Stores then you can ...

• Updating Your USPS Credentials in Spirit Sale (Migration to New USPS APIs)

  Who Does This Apply To This information only applies to Spirit Sale stores still using the older USPS Web Tools (Legacy) API for live shipping rates. You do NOT need to follow this guide if: You don't use USPS for shipping. You already migrated to ...

• How to Feature a Product in Spirit Sale

  1.) When logged into your Spirit Sale backend. Navigate to Store Fronts --> Stores. 2.) Then select the store where you want to select items to feature. 3.) Then select the Products tab 4.) Under Actions click the Edit button next to the product ...