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 April 11, 2024

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, as well as various local payment gateways like Alipay, Apple Pay, Google Pay, Payment Request Button, 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.
  • 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 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.

Stripe supports payment transactions in 46 countries. Ensure that you belong to the listed country.

  1. On signing up, navigate to Stripe dashboard > Developers > API keys.
  2. Copy the Publishable key and Secret key to the clipboard.
Stripe Dashboard
Stripe Dashboard

Note: Transaction mode (test/live) is dictated by the respective API keys. In live mode, an SSL certificate must be installed on your site to use Stripe.

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.
Stripe Payment Gateway Plugin for WooCommerce icon
Stripe Payment Gateway Plugin for WooCommerce icon
WebToffee Stripe - Dashboard
WebToffee Stripe – Dashboard

Configure Stripe General settings

Stripe Payment Gateway Plugin for WooCommerce - General settings
Stripe Payment Gateway Plugin for WooCommerce – General settings
  • Stripe Credentials –
    • Transaction mode – List the available modes for transactions
      • Choose Test mode to trial run using test API keys.
      • Switch to live mode to begin accepting payments with Stripe using live API keys.
    • Publishable key – In test mode, insert the test publishable key, and in live mode, insert the live publishable key.
    • Secret key – In test mode, insert the test secret key, and in live mode, insert the live secret key.
  • 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 days. Learn more

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

Enable the concerned payment gateway

Enable the required local payment gateways the plugin offers by navigating to the Local payment gateway tab.

Learn more about settings up payment gateways: