How to Add Stripe Payments to a WordPress Site

Updated 9 November 2026 · Standard formula, shown below

Adding Stripe payments lets visitors pay on your WordPress site by card and, depending on your setup and location, other supported payment methods. You’ll connect a Stripe account through a compatible WordPress plugin, configure a checkout option, and test a payment before accepting real orders.

What You’ll Need

A WordPress site where you can install and configure plugins, usually with administrator access.
A Stripe account. You can often connect in test mode before completing account activation; Stripe may require business and identity details before live payments and payouts are available.
An active HTTPS certificate for your website. Payment pages and checkout should load securely over HTTPS.
A payment plugin that suits your site: for example, a Stripe payment plugin for simple payments, or an ecommerce plugin with Stripe support for a product catalog, cart, orders, and shipping.
Details for your checkout, such as the items or services sold, currency, payment confirmation message, and refund or contact information.

Step-by-Step

Choose the right payment setup. If you need a store with products, inventory, shipping, and order management, use an ecommerce plugin that offers Stripe as a payment gateway. For a donation, booking, or one-off payment, a dedicated Stripe payment plugin or payment form may be enough. Check that the plugin is maintained, compatible with your WordPress setup, and supports the payment flow you need. Avoid installing multiple plugins that handle the same checkout.
Prepare your site and Stripe account. Sign in to WordPress and make a recent backup before changing payment settings. Confirm that your site uses HTTPS by checking for the secure connection indicator in your browser and that WordPress and its plugins are up to date. Create or sign in to your Stripe account, then provide any requested account, business, and payout details. Requirements vary by country and business type.
Install the plugin. In WordPress, open Plugins > Add New, search for the plugin you chose, and review its publisher, documentation, and recent maintenance information. Select Install Now, then Activate. If the plugin is supplied as a ZIP file, use Plugins > Add New > Upload Plugin and upload the file from its trusted source.
Connect Stripe. Open the plugin’s settings. The location varies; look under Settings, the plugin’s own menu, or your ecommerce plugin’s Payments section. Choose Stripe and use its connection or authorization button if available. Sign in to Stripe and approve the requested connection, then return to WordPress and confirm the account is connected. This is safer and less error-prone than copying API keys manually.
Set test mode and checkout details. Enable test or sandbox mode in the plugin, and make sure its Stripe connection is also using test credentials. Configure the display name, currency, payment button or checkout option, and the page or message shown after payment. For a store, enable Stripe in the store’s payment settings and review the checkout page, order emails, shipping, and tax settings separately. A currency offered by a plugin may not be available for every Stripe account or payment method.
Add the payment option to a page. Follow the plugin’s instructions to add its block, shortcode, or checkout component. For a simple payment form, create a dedicated page and specify what the customer is paying for and the amount, if applicable. For a store, add products through the ecommerce plugin and use its normal cart and checkout pages. Preview the page on desktop and mobile, and verify that the amount, currency, and payment description are clear before publishing.
Run a complete test checkout. Use the plugin’s documented Stripe test-card details while test mode is enabled; never use real card details for a test. Check that the payment succeeds, the confirmation page appears, and the order or payment is recorded in both WordPress and Stripe’s test data. Also try a declined or incomplete test if the plugin documents a safe way to do so. Check customer emails and any fulfillment or booking steps.
Switch to live payments carefully. Complete Stripe’s requested account verification, then turn off test mode or connect the live account using the plugin’s instructions. Confirm that the website is HTTPS, the live currency and amount are correct, and the live checkout is enabled. Make a small, legitimate purchase only if appropriate, then verify the payment and refund process. Do not leave test mode enabled on a public checkout or expose secret API keys in page content, screenshots, or public code.

Common Mistakes

Mixing test and live settings: A test account or test API key cannot process live charges. Check the mode in both Stripe and the plugin.
Using an insecure page: An HTTPS certificate should be installed and working across the site, not just on one checkout URL. Fix redirect or mixed-content problems before taking payments.
Installing overlapping payment tools: Multiple gateways or checkout plugins can create duplicate buttons, conflicting scripts, or confusing order records. Keep only the components you need.
Skipping a full checkout test: A visible payment button does not prove that confirmation, order status, email, and fulfillment work correctly.
Assuming every payment method is available: Availability depends on the Stripe account, country, currency, plugin, and transaction. Enable only methods supported by your setup.
Sharing secret keys: Never paste a secret key into a public page or send it in a public support post. Use the plugin’s protected settings and Stripe’s connection flow.

Tips

Keep WordPress, the payment plugin, and the ecommerce plugin updated, but make a backup and check compatibility before significant updates.
Use the plugin’s built-in connection where possible; if manual keys are required, copy the correct test or live keys into the matching mode only.
Use a clear payment description and show the total, currency, and any recurring-payment terms before the customer confirms.
Review Stripe and WordPress records after launch. Set up order notifications and decide who will respond to payment questions, refunds, and failed payments.
Consult the plugin’s documentation for its checkout blocks, webhooks, and supported payment methods. Exact setting names differ between plugins and may change over time.

Troubleshooting

The connection button fails or Stripe does not connect: Sign in to the intended Stripe account in a separate browser tab, check that your WordPress user has administrator permissions, and retry the plugin’s authorization flow. Temporarily disable browser extensions that interfere with pop-ups. If the plugin offers manual connection, follow its current instructions and confirm the keys match the selected mode.

The checkout is missing or the page shows an error: Confirm that the payment method is enabled, the page contains the required block or shortcode, and test mode is intentional. Check the plugin’s setup notes for required pages. Clear site and browser caches, then temporarily disable other plugins one at a time on a staging site to identify a conflict. Restore normal plugins after testing.

A test payment is declined: Verify that test mode is on and use the test details documented by Stripe and the plugin. Test cards do not work against live credentials, and real cards should not be used with test credentials.

A customer paid but the order did not update: Compare the payment status in Stripe with the WordPress order record. Check plugin logs and webhook or notification status in the plugin and Stripe dashboards. Follow the plugin’s webhook setup instructions, since endpoint configuration varies. Avoid asking the customer to pay again until you have checked whether the first payment succeeded.

Live payments are unavailable: Review Stripe’s account notifications for requested verification or other account actions, and confirm the plugin is using live mode and live credentials. Contact Stripe or the plugin’s support team if the dashboard does not explain the issue. Do not share secret keys when requesting help.

Frequently Asked Questions

Can I accept Stripe payments on WordPress without an online store?
Yes. A payment form or button plugin can suit one-off payments, donations, or bookings. Choose an ecommerce plugin if you need a product catalog, cart, inventory, or shipping workflow.

Do I need a Stripe account before installing a plugin?
You need a Stripe account to connect and process payments. Some plugins let you start setup or test mode first, but live payments generally require completing Stripe’s requested account steps.

Can I use Stripe in test mode before going live?
Yes. Use the plugin’s test mode and Stripe’s documented test payment details. Test the entire checkout and switch to live mode only when you are ready to accept real payments.

Why does the payment option not appear at checkout?
It may be disabled, disconnected, unavailable for the selected currency or account, or affected by a plugin conflict. Check the gateway settings, mode, checkout page, and plugin documentation.

Does adding Stripe automatically make my site compliant?
No. Stripe and a plugin handle payment processing, but you remain responsible for accurate checkout information, privacy notices, customer support, and any applicable business obligations. Get advice appropriate to your location if needed.

Can I add Stripe payments to a free WordPress.com site?
It depends on the WordPress.com plan and the payment features currently available to that site. Check your dashboard’s plugin and commerce options; self-hosted WordPress sites generally allow plugin installation with administrator access.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.