Home > Docs > Stripe Payment Gateway for WooCommerce > Stripe Payment Gateway Plugin for WooCommerce – Setup Guide

Stripe Payment Gateway Plugin for WooCommerce – Setup Guide

Last updated on January 8, 2025

The Stripe Payment Gateway Plugin for WooCommerce empowers WooCommerce store owners to seamlessly accept payments from their online stores. With this plugin, businesses can offer customers multiple payment options, including Credit/Debit Cards, Express payment buttons (Apple Pay, Google Pay, Link), and various local payment gateways like Alipay, SEPA Pay, Klarna, and Stripe Checkout through the Stripe platform.

Features offered

  • Stripe Overview Page: A consolidated overview of all the Stripe payments. Capture payments and refunds manually. It also displays a graphical representation of the overview of the Stripe payment for a given period of time. Process partial or full refunds. Displays all the order/transaction details as well.
  • Pay with Local payment gateways.
  • Express Payment Buttons: Express Payment Buttons support Apple PayGoogle Pay, and Link for faster and smoother checkout experiences. Customers can make secure payments with just a few clicks without needing to enter payment details manually.
  • Customize your Stripe Checkout (custom text, description, and logo for the Stripe payment gateway.)
  • Save card details:  Save customers card details so that it’ll be easy for them to use them for their next transaction.
  • Capture Payments: Capture payments immediately or capture them manually from the Stripe Overview Page or Dashboard.

Prerequisite

Before anything else, ensure that you have a Stripe account in place. Creating a Stripe account is free of charge. Additionally, Stripe provides the option to test payments in a test mode. Please refer to Stripe’s guidelines on business information requirements.

Note: Stripe supports payment transactions in 46 countries. Ensure that your country is on the supported list.

Getting started

To begin with, install and activate the plugin. The settings can be accessed in two ways:

  • From the dashboard, navigate to Plugins > Installed plugins > Stripe Payment Gateway for WooCommerce > Settings.
Image indicating the plugin settings
Image indicating the plugin settings

OR

  • From the WordPress dashboard, click on WebToffee Stripe.
WebToffee Stripe icon in the dashboard
WebToffee Stripe icon in the dashboard

WebToffee Stripe General Settings page will look like this:

For an existing user

WebToffee Stripe - General Settings
WebToffee Stripe – General Settings

For a new user

General Settings of WebToffee Stripe plugin
General Settings of WebToffee Stripe plugin

Configure Stripe settings

We are enhancing security and require you to switch from using API keys to OAuth 2.0 for connecting your Stripe account. OAuth provides better control and limits access to only the necessary data, protecting your business from unauthorized access.

Connect your Stripe account using the OAuth 2.0 method

  1. If you are a new user starting from scratch, upon heading to the WebToffee Stripe menu, you’ll be prompted to connect your Stripe account.
Connect to Stripe button
Connect to Stripe button
  1. If you are an existing user, from the WordPress dashboard, head to WebToffee Stripe > General Settings. Under the General Settings, a banner at the top prompts you to connect your Stripe account using the OAuth 2.0 method.
WebToffee Stripe - Connect to Stripe button
WebToffee Stripe – Connect to Stripe button
  1. Switch to the live mode to receive live payments.
  2. Click on the Connect now button, which will take you to the Stripe Sign-in page(if you haven’t already signed in).
  3. After signing in to your Stripe account, you’ll be prompted to install the WebToffee Stripe App.
  4. Proceed with installing the app. Once all the steps are completed correctly, you will see a message indicating successful installation. After the app is successfully installed, you will be redirected back to the plugin page.
  5. Now, you can see that your Stripe account is successfully connected.

For detailed instructions on how to complete the connection, check out the following article: Connect Stripe via OAuth 2.0.

Upon successful completion, the general settings page will appear like this:

WebToffee Stripe - General Settings
WebToffee Stripe – General Settings
  • Stripe overview page – Enable to add a sub-menu named “Stripe Overview” that replicates a Stripe dashboard and provides options to manage orders, process partial/full refunds, and capture payments. Keep the option disabled if you don’t want to have a stripe overview. Refer to the documentation to learn more about the Stripe Overview.
Stripe Payment Gateway Plugin for WooCommerce - Stripe Overview
Stripe Payment Gateway Plugin for WooCommerce – Stripe Overview
  • Capture payment immediately – Enabled by default to capture the payments immediately on successful transactions. Disable to capture payments later manually from the Stripe dashboard/overview/order details page. Further, read to know more about how to capture Stripe payments manually from Stripe overview.

Un-captured payments will expire in 7 daysLearn more.

  • Express payment button position – This option allows you to control where the express payment buttons (Apple Pay, Google Pay, and Link) appear in relation to the order button.
  • Express payment button height – This option allows you to customize the height of the express payment buttons (Apple Pay, Google Pay, and Link). Enter a value in the text box to set the button height, with a range between 40 px to 55 px.
  • Webhooks – To receive order status updates in a timely manner, add the site’s webhook to the Stripe dashboard. Follows the steps in – Setting up Webhooks and Supported events article to add a webhook endpoint. The plugin is compatible with the following webhook events:
    • charge.dispute.created
    • charge.succeeded
    • charge.failed
    • checkout.session.expired
    • source.chargeable
    • source.failed
    • payment_intent.succeeded
    • payment_intent.payment_failed
    • checkout.session.async_payment_succeeded
    • checkout.session.async_payment_failed
  • Debug – Records stripe payment transactions into WooCommerce status log.
    • Log – Enable to record stripe payment transactions in a log file.
  • Clicking on Save changes will save the configuration.

Enabling Payment Gateways

The following payment gateways are available within the plugin and can be enabled based on your business needs:

  1. Credit/Debit Card Payment
    Enable standard card payments for your store.
  2. Express Payment Buttons
  3. Stripe Checkout
    • Use Stripe Checkout to handle payments through Stripe’s hosted payment page.
    • Supports Cash App Pay.
  4. Local Payment Gateways