WebToffee Logo
  • Home
  • Plugins
  • Blog
  • Documentation
  • Support
Login
0

  • Overview of the Plugin
  • Installation of the Plugin
  • Pre-requisites for the Plugin
  • Getting started with the Plugin
  • Set up and Configuration of the Plugin
  • Stripe Alipay
  • Stripe Checkout
  • Stripe Overview

WooCommerce Stripe Payment Gateway – User Guide

Last updated on February 15, 2021

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

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

Pay via Stripe Checkout
Pay via Stripe Checkout

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.

Pay using Stripe Checkout

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.

Stripe overview page

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.

  • Was this article helpful?
  • YesNo

Written by

Haritha

Haritha writes for WebToffee on everything related to WordPress/WooCommerce plugins in simple tutorials, blogs, and documentation to help run your WooCommerce store.

Leave a Reply

Cancel reply

Your email address will not be published. Required fields are marked *

We develop awesome WordPress plugins & WooCommerce extensions to help build successful online businesses.

Get Started

  • Plugins
  • Testimonials
  • Affiliates

Help & Support

  • Documentation
  • Documentation (Basic)
  • FAQ
  • Support

Company

  • Terms & Conditions
  • Privacy Policy
  • Refund policy
  • License Activation

© 2021 WebToffee. All rights reserved.

We use cookies on our website to give you the most relevant experience by remembering your preferences and repeat visits. By clicking “Accept”, you consent to the use of ALL the cookies. However you may visit Cookie Settings to provide a controlled consent.
Cookie settingsACCEPT
Privacy & Cookies Policy

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of the basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website, to store user preferences and provide you with content and advertisements that are relevant. Such cookies will be stored on your browser but only upon procuring consent.

You will also have the option to opt-out of these cookies should you want to. But opting out of some of these cookies may have an effect on your browsing experience as per the descriptions elucidated against the respective categories below.

Necessary
Always Enabled

The cookies defines under this category are absolutely essential for the website to function. Hence they are loaded by default irrespective if user consent.

CookieDescription
PHPSESSIDThis cookie is native to PHP applications. The cookie is used to store and identify a users' unique session ID for the purpose of managing user session on the website. The cookie is a session cookies and is deleted when all the browser windows are closed.
viewed_cookie_policyThe cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.
Analytics

Analytics cookies help us understand how our visitors interact with the website. It helps us understand the number of visitors, where the visitors are coming from, and the pages they navigate. The cookies collect this data and are reported anonymously.

CookieDescription
_gaThis cookie is installed by Google Analytics. The cookie is used to calculate visitor, session, camapign data and keep track of site usage for the site's analytics report. The cookies store information anonymously and assigns a randoly generated number to identify unique visitors.
_gat_gtagIdentification code of website for tracking visits.
_gidThis cookie is installed by Google Analytics. The cookie is used to store information of how visitors use a website and helps in creating an analytics report of how the wbsite is doing. The data collected including the number visitors, the source where they have come from, and the pages viisted in an anonymous form.
_hjidHotjar cookie. This cookie is set when the customer first lands on a page with the Hotjar script. It is used to persist the random user ID, unique to that site on the browser. This ensures that behavior in subsequent visits to the same site will be attributed to the same user ID.
_hjIncludedInSampleThis cookie is set to let Hotjar know whether that visitor is included in the sample which is used to generate Heatmaps, Funnels, Recordings, etc.
has_recent_activityThis cookie is used to signal to the code repository website if the user has browsed other website resources during the current session.
tk_aiGathers information for our own, first party analytics tool about how our services are used. A collection of internal metrics for user activity, used to improve user experience.
tk_lrThis cookie is set by JetPack plugin on sites using WooCommerce. This is a referral cookie used for analyzing referrer behavior for Jetpack
tk_orThis cookie is set by JetPack plugin on sites using WooCommerce. This is a referral cookie used for analyzing referrer behavior for Jetpack
tk_qsGathers information for our own, first party analytics tool about how our services are used. A collection of internal metrics for user activity, used to improve user experience.
tk_r3dThe cookie is installed by JetPack. Used for the internal metrics fo user activities to improve user experience
Advertisement

Advertisement cookies help us provide our visitors with relevant ads and marketing campaigns.

CookieDescription
_fbpThis cookie is set by Facebook to deliver advertisement when they are on Facebook or a digital platform powered by Facebook advertising after visiting this website.
frThe cookie is set by Facebook to show relevant advertisments to the users and measure and improve the advertisements. The cookie also tracks the behavior of the user across the web on sites that have Facebook pixel or Facebook social plugin.
Preferences

Preference cookies are used to store user preferences to provide them with content that is customized accordingly. This includes the language of the website or the location of the visitor.

CookieDescription
_gh_sessThis cookie is used to preserve users states across page requests.
Save & Accept