This is a complete documentation of the WooCommerce Stripe Payment Gateway plugin.
Overview of the Plugin
The WooCommerce Stripe Payment Gateway plugin allows you to integrate Stripe payment to your WooCommerce store. Using the plugin you can accept payments via credit cards, Alipay, and Stripe checkout in your WooCommerce store.
Installation of the Plugin
You can install the plugin either from the WordPress plugin directory or as a zip downloaded from the WordPress.org website. You can learn more about the installation procedure by reading the article How to Install a Free Plugin from WordPress.
Pre-requisites for the Plugin
The plugin requires you to Signup and create a Stripe Account.
Getting started with the Plugin
Once the plugin is installed and activated, you can navigate to plugin settings in two ways:
- Dashboard > WebToffee Stripe/Alipay/Stripe Checkout(or)
- Dashboard > Plugins > Installed Plugins > Stripe Payment Gateway for WooCommerce > Settings.
Set up and Configuration of the Plugin
Stripe
This section allows you to accept credit card payments directly on your website via WebToffee Stripe payment gateway.

Stripe Credentials

Here you have to provide the necessary credentials for enabling stripe checkout for your users.
You can find the API keys by logging into your Stripe dashboard. Transaction mode(test/live) is dictated by the respective API keys.
- Transaction mode – Here you can choose the transaction mode as either test or live. You can choose ‘Test’ for configuring the plugin as per your requirements and to validate your transactions. You can switch to live mode when you have set up the configurations as required.
- Test Publishable Key – You can copy and paste the Stripe test mode publishable key from the Stripe dashboard into the text field. If it’s in the live mode, you will have to enter the live publishable key.
- Test secret key – Here you can copy and paste the Stripe test mode secret key from the Stripe dashboard into the text field. If you have chosen Live mode it will be Live secret key.
Stripe Settings

- Stripe Payment – Enable this option to have a Stripe payment option in your checkout.
- Stripe overview page – Here you can enable a Stripe overview page on your dashboard. It provides you with a consolidated view of all your transactions.
- Title – The text entered in this field will be displayed as the title for the Stripe payment at the checkout page of your WooCommerce store.
- Description – The text entered in this field will be displayed as a short description for the Stripe payment at the checkout page of your WooCommerce store.
- Order button text – Here you can add a text of your choice that will appear as the order button label at the checkout.
- Preferred cards – Here you can choose the preferred cards from the list for which the payment can be accepted. Transactions will be limited to the selected cards and the rest will be declined.
Stripe Actions

- Capture Payment – When you enable it, the payment will be captured by your store immediately upon successful completion of the transaction. Disabling this option will require the shop manager to manually capture the payments at a later date (within 7 days from the transaction date) via the Stripe overview page or the Stripe dashboard.
- The capture later payment method is most widely used to reserve funds from the cardholder and capture them after the business completes the service.
- Email Transaction Receipt – You can enable this option to send transaction receipts via email to your customers.
- Statement Descriptor – Here you can enter a statement descriptor (a short description about the purchase that will show up on the bank statement -of the customer- in capital letters alongside the charge. It may contain up to 22 characters with at least one letter and no special characters.
Debugging
Here you can enable logging to save Stripe payment logs into log file.

- Logging – Enabling the logging option will save each transaction information into the log file. You can see the file path and the size of the log file which will help in tracking disputes.
Finally, click the Save changes button to save all the configurations.
Stripe Alipay

Here you can configure your WooCommerce store to accept payments using Alipay.
Prerequisite: Stripe credentials should be configured within the Stripe tab.
- Enable/Disable – Enable this option to have an Alipay payment option in your checkout.
- Title – The text entered in this field will be displayed as the title for for the Alipay payment at the checkout.
- Description – The texts entered in this field will be displayed as a short description for the AliPay payment at the checkout.
- Order Button Text – Here you can add a text of your choice that will appear at the checkout page as the order button text.
Click Save changes.
When you have configured all the above settings, move to the checkout page to pay via Alipay.

You will be then taken to an Alipay’s site to authorize the transaction. On successful authentication, you will be returned to the merchant site where the order will be placed.
Stripe Checkout

Prerequisites
- For enabling Stripe Checkout, you will have to specify an account name on the Stripe Dashboard (if you haven’t already) as shown below.

2. Stripe account credentials should be configured inside the Stripe tab.
- Enable/Disable – Enable this option to have a Stripe checkout payment option in your checkout.
- Title – The texts entered in this field will be displayed as the title for the Stripe checkout payment at the checkout.
- Description – The texts entered in this field will be displayed as a short description for the stripe checkout payment at the checkout.
- Order button text – You can key in the text of your choice that will appear at the checkout page as the order button text.
Click Save changes.
When you have configured all the above settings, move to the checkout page and view Stripe checkout enabled.
You can click on the option Stripe Checkout from the checkout page.

You will be redirected to the stripe portal with a prompt to specify the card details. Once the order is processed, you will be taken back to the store to complete the order.
Help Guide
Inside the help guide you can find links to the documentation and Support.

Stripe Overview
The stripe overview page provides you with a consolidated view of all your transactions. From the overview page, you will be able to manage your orders, process partial or full refunds, capture payments, and change order status, etc.

Capturing Payment in Stripe
If you wish to capture payment at a later date via Stripe follow the below steps.
Step 1 – Disable the ‘Capture Payment immediately’ option under the Stripe Actions.

Step 2 – Go to the ‘Order details’ section on the Stripe Overview page.
Step 3 – Locate the specific order and click the capture button across it. The specified amount of money will be deducted from the customer’s account.

Processing Refunds in Stripe
You can process both full and partial refunds via Stripe through the overview page of the plugin.
Processing Full Refunds
Step 1 – Go to the Order Details section inside the page.
Each processing order would be listed there.
Step 2 – You can enable the ‘Full’ checkbox across the order you wish to refund and click the Refund button beside it.
The order amount will be fully refunded and credited to your customer’s account.

Processing Partial Refunds

Step 1 – Go to the Order Details section inside the page.
Each processing order would be listed there.
Step 2 – Locate the order and disable the ‘Full’ checkbox against it.
A new field appears where you can enter the amount that should be refunded.
Step 3 – Enter the amount and click the Refund button.
Now the specified amount will be fully refunded and credited to your customer’s account.
To partially refund a particular order deselect the ‘Full’ checkbox across the order and enter the amount you wish to refund and click the refund button.
Changing Order Status
If you wish to change the status of a particular order to ‘Complete’. You can click the Complete button against the order and change the order to complete.
To bulk change order status you can select all the orders you wish to change and choose the order status from the bulk actions drop-down.
