How to configure Stripe payment gateway on Shopify

beginner 8 min read Updated 2026-03-18
Quick Answer

Configure Stripe on Shopify by accessing Settings > Payments, selecting Stripe as your payment provider, and entering your API keys. Complete the setup by testing transactions and configuring payment methods.

Prerequisites

  • Active Shopify store
  • Stripe account with business verification completed
  • Admin access to your Shopify store
  • Valid business bank account linked to Stripe

Step-by-Step Instructions

1

Access Shopify Payment Settings

Log into your Shopify admin dashboard and navigate to Settings in the bottom left corner. Click on Payments from the settings menu. This will open your store's payment configuration page where you can manage all payment providers.
Make sure you're logged in as the store owner or have payment settings permissions
2

Select Stripe as Payment Provider

In the Payment providers section, click Choose third-party provider. Search for Stripe in the list of available payment gateways and click Activate Stripe. You'll be redirected to the Stripe configuration page.
If you don't see Stripe, ensure your store is in a supported country for Stripe payments
3

Connect Your Stripe Account

Click Connect with Stripe to link your existing Stripe account, or Create account if you don't have one. Enter your Stripe login credentials when prompted. Grant Shopify permission to access your Stripe account by clicking Authorize access to this account.
Use the same email address for both Shopify and Stripe to avoid connection issues
4

Configure Payment Methods

In the Stripe settings, select which payment methods to enable: Credit cards, Apple Pay, Google Pay, and Shop Pay. Toggle on your preferred options. Set up Express checkout options by checking the boxes for faster customer checkout experience.
Enable multiple payment methods to reduce cart abandonment and increase conversions
5

Set Up Webhook Endpoints

Scroll down to Webhook settings and click Create webhook endpoint. Copy the webhook URL provided by Shopify: https://yourstore.myshopify.com/services/stripe/webhooks. In your Stripe dashboard, go to Developers > Webhooks and add this endpoint.
Webhooks ensure order status updates sync properly between Stripe and Shopify
6

Configure Currency and Fraud Settings

Under Currency settings, select your store's primary currency. Enable Stripe Radar for fraud protection by toggling it on. Set your risk tolerance level: Low, Normal, or High based on your business needs.
7

Test the Payment Setup

Enable Test mode in the Stripe settings. Use Stripe's test card number 4242 4242 4242 4242 with any future expiry date and CVC. Place a test order on your storefront to verify the payment flow works correctly. Check that the order appears in both Shopify and Stripe dashboards.
Always test both successful and failed payment scenarios before going live
8

Activate Live Payments

Once testing is complete, return to your Stripe settings in Shopify and disable Test mode. Click Save to activate live payments. Your Stripe payment gateway is now ready to process real customer transactions on your Shopify store.
Monitor your first few live transactions closely to ensure everything processes smoothly

Common Issues & Troubleshooting

Stripe not appearing in payment providers list

Ensure your Shopify store is located in a Stripe-supported country. Check that you're using a compatible Shopify plan and that your store's currency is supported by Stripe.

Connection failed when linking Stripe account

Verify you're using the correct Stripe account credentials. Clear your browser cache and cookies, then try reconnecting. Ensure your Stripe account has completed business verification.

Payments failing with 'Invalid API key' error

Check that your API keys are correctly entered in Shopify. Verify you're using live keys for production and test keys for testing. Regenerate API keys in Stripe if needed.

Orders not syncing between Shopify and Stripe

Verify your webhook endpoint is properly configured in both platforms. Check that the webhook URL is active and receiving events. Re-save your Stripe settings in Shopify to refresh the connection.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Shopify website before purchasing.