Stripe Payment Plugin for WooCommerce – User Guide

The Stripe Payment Plugin for WooCommerce(free) allows you to integrate Stripe payment into your WooCommerce store. Using the plugin, you can accept payments via Credit/Debit Cards, Alipay, Apple Pay, Payment Request Button(GPay), Stripe Checkout, SEPA, Klarna, WeChat, Afterpay, and many other local payment gateways in your WooCommerce store.

You can install the plugin from the WordPress plugin directory or as a zip downloaded from the WordPress.org website. To know more about installing a free plugin, refer to the following article: Installing a Free Plugin from WordPress.

The plugin requires you to sign up and create a Stripe Account.

Once the plugin is installed and activated, you can navigate to the plugin settings in two ways:

1. From the WordPress dashboard, navigate to WebToffee Stripe.

OR

1. From the WordPress dashboard, navigate to Plugins > Installed Plugins > Stripe Payment Plugin for WooCommerce > Settings.

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.
2. If you are an existing user, from the WordPress dashboard, head to WebToffee Stripe > General Settings. Under General Settings, a banner at the top prompts you to connect your Stripe account.

3. Switch to the live mode to receive live payments.
4. Click on the Connect Now button, which will take you to the Stripe Sign-in page(if you haven’t already signed in).
5. After signing in to your Stripe account, you’ll be prompted to install the WebToffee Stripe App.
6. 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.
7. Now, you can see that your Stripe account is successfully connected.

For more details, check out the following article: Connect Stripe via OAuth 2.0.

Stripe Overview

Replicates a stripe dashboard view. It gives provisions for managing orders, processing partial/full refunds, and capturing payments. Keep the option disabled if you don’t want a stripe overview. To learn more, refer to the following article: Enabling Stripe Dashboard Within WordPress.

Capture Payments

By default, the Capture payment immediately option is enabled to capture payments immediately on successful transactions. However, if you wish to capture payments later, disable the option. Learn more by referring to the following article: Capturing Stripe Payments and Processing Refunds.

Payments can be captured later manually from the Stripe dashboard or overview. Uncaptured payments expire in 7 days.

G Pay/Apple Pay button position

Option to customize the placement of the G Pay and Apple Pay buttons.

G Pay/Apple Pay button height

Allows you to customize the height of the G Pay and Apple Pay buttons. Input a value between 40 and 55 pixels.

It is recommended that you add your site’s webhook to the Stripe dashboard to receive order status updates in a timely manner.

1. First, copy your site’s webhook URL from the webhooks section.

2. To insert the webhook,
   • 1. Go to the Stripe dashboard.
   • 2. Click on the Developers option at the top.
   • 3. Head to the Webhooks tab.
   • 4. Click on the Add an endpoint button.
   • 5. Insert your site’s webhook endpoint URL.
   • 6. Add events.
   • 7. Click on Add endpoint.

A list of webhook events that are compatible with the plugin is given below:

• charge.refund.updated
• charge.dispute.created
• charge.succeeded
• charge.failed
• checkout.session.expired
• source.chargeable
• source.failed
• payment_intent.succeeded
• payment_intent.payment_failed

For more details on adding webhook, check out the following article: Configure Webhook for Order Status Updates.

3. Upon adding the endpoint, copy the webhook secret and paste it into the plugin’s Webhook secret section.

4. Finally, click on Save Changes.

Debug

Records stripe payment transactions into the WooCommerce status log.

Click on Save Changes to save settings.

The five types of payment gateways offered by the plugin are the following:

• Credit/Debit Cards
• Apple Pay
• GPay/Payment Request Button
• Stripe Checkout
• Local Payment Gateways

Accepts Stripe payments via credit or debit cards.

To access the credit/debit card settings, head to WebToffee Stripe > Credit/Debit Cards from the WordPress dashboard.

• Credit/Debit cards: Enable to accept credit/debit card payments through Stripe.
• Title: Input a title for the payment gateway displayed at the checkout.
• Description: Input texts for the payment gateway displayed at the checkout.
• Order button text: Type the text that will appear on the order button when you place an order at the checkout.
• Allowed Cards: Accepts payments using selected cards. Displays the Icons of chosen cards at the checkout. Cards supported by the plugin are the following:
  • MasterCard
  • Visa
  • American Express
  • Discover
  • JCB 
  • Diners Club
• Card fields in a row: Choose the style you want to show your credit card form. When checked, the credit card form will display the credit card number field, expiry date, CVV, and postal code in a single field.
  

• Email Transaction Receipt: Enable this option to send transaction receipts via email to customers. Works in live mode only.
• Statement Descriptor: You can enter a statement descriptor that will appear on customers’ bank statements when they make or receive payments. A complete statement descriptor – either a single static descriptor or the combination of a prefix and suffix – must meet the following requirements:
  • Contains between 5 and 22 characters, inclusive.
  • Contains at least one letter.
  • Does not contain any of the special characters < > \ ‘ ” *.
  • Reflects your doing business as (DBA) name.
  • Contains more than a single common term or common website URL. A website URL is only acceptable if it provides a clear and accurate transaction description on a customer’s statement.

Finally, click Save Changes to save/update the settings.

After configuring all the settings, move to the checkout page to view the credit/debit card checkout process.

Specify the card details, such as the Card Number, Expiry Date, and CVV, and then click on the Pay via Stripe button to continue the payment process.

Head to WebToffee Stripe > Apple Pay to access the Apple Pay settings.

• Apple Pay: Apple Pay allows you to accept payment via Apple Pay.
• Show on pages: The Apple Pay button will be shown on selected pages.
  

• Button settings:
  • Color: Choose the button color from the standard white or black for it to appear accordingly at the checkout.
  • Text: You can choose a suitable Apple Pay button text from the following options:
    • Apple Pay
    • Buy with Apple Pay
    • Set up Apple Pay

Finally, click Save Changes to save/update the plugin settings.

To access the GPay/Payment Request Button settings, head to WebToffee Stripe > GPay/Payment Request Button from the WordPress dashboard.

• Google Pay: Enable to accept G Pay payments.
• Show on pages: You can display the payment request button on the cart, checkout, or product page.
• Button Settings:
  • Type: Select the button type you want to have as Buy, Pay, or Donate.
  • Theme: Choose the button theme as either a dark, light, or light outline.

Finally, click Save Changes to save/update the plugin settings.

The Google Pay button on the cart page will appear in the following manner:

1. Navigate to WebToffee Stripe > Stripe checkout from the WordPress dashboard to access the Stripe Checkout settings.

• Stripe Checkout: Enable to accept Stripe checkout payments.
• Title: Enter a custom title for stripe checkout payment. This title will be visible on the checkout page.
• Description: Enter a custom description for stripe checkout payment. This description will be visible on the checkout page.
• Order Button Text: Enter a custom text for the stripe checkout button.
• Locale: Choose a language code from the dropdown.
• Send line items to stripe: Enable to view all order line items like tax, shipping, fees, discount, etc. at the stripe hosted payment page.
• Ask for address details from the stripe hosted page: Enable to receive billing and shipping addresses at the stripe hosted payment page.

Finally, click on Save Changes to save/update the plugin settings.

The Stripe checkout workflow is as shown below:

The plugin supports the following local payment gateways: Alipay, SEPA Pay, Klarna, Afterpay, WeChat Pay, iDEAL Pay, Bancontact Pay, EPS Pay, Przelewy24 Pay, Bacs, BECS, FPX, Boleto, OXXO, GrabPay, Affirm.
For detailed information on the local payment gateways offered, check out the following article: Local Payment Gateways Offered by Stripe.

Provides direct links to resources like documentation and support.