1. Documentation /
  2. Stripe WooCommerce Extension /
  3. Setup and Configuration of the Stripe WooCommerce Extension /
  4. Settings Guide

Settings Guide

Once you’ve connected your Stripe account and configured your webhooks, you can begin accepting payments via the Stripe WooCommerce Extension! However, you may want to adjust some of the plugin settings to change the checkout experience or enable other ways for customers to pay.

This guide will walk you through the Stripe WooCommerce Extension settings. It is broken down into the four main sections at WooCommerce > Settings > Payments > Stripe > Settings:

  1. General
  2. Account details
  3. Payments & transactions
  4. Advanced settings

NOTE: If you would like to adjust the Radar rules of your Stripe account, you can do so from the Stripe dashboard. You can learn more about Stripe Radar here.


↑ Back to top

The General section of the Stripe WooCommerce Extension settings controls if and how the Stripe payment option is presented to customers.

In the General section, you can:

  1. Enable or disable Stripe as a payment option for customers.
    • Checking the box will enable the Stripe payment method on checkout.
    • Unchecking the box will prevent the Stripe payment method from appearing on checkout.

NOTE: If the new checkout experience is enabled, this option will display differently in the settings, and you will be able to modify the payment method name displayed on your site’s checkout page.

  1. Enable test mode, which allows those visiting your site to simulate a transaction using test card numbers.
    • You can learn more about how to enable test mode here.

Account details

↑ Back to top

The Account details section serves as a place to get an overview of the capabilities of your Stripe account from your WooCommerce dashboard and how well it is communicating with your site and the Stripe WooCommerce Extension.

In the Account details section, you can:

  1. Determine the email address associated with your Stripe account.
  2. Retrieve the connected Stripe account ID.
  3. Determine the connected account’s ability to accept payments.
    • There may be instances where Stripe will restrict or reject an account’s ability to receive payments.
  4. Determine the payout eligibility of the connected account.
    • There may be instances where Stripe will restrict or reject an account’s ability to process payouts.
  5. Determine if a webhook secret is saved.
  6. Determine if webhooks are being actively sent and received by Stripe’s servers.
  7. Modify the Stripe account keys currently in use on your site.

Payments & transactions

↑ Back to top

The Payments & transactions section allows you to configure optional payment settings and transaction details for the Stripe WooCommerce Extension.

Enable payments via saved cards, if checked, allows customers to save their payment info on your site, which lets them to check out much faster in the future. The payments methods that can be saved are:

  • Credit/debit cards
  • SEPA Direct Debit

If you have the new checkout experience enabled, these can also be saved:

  • Bancontact
  • iDEAL

NOTE: The Enable payments via saved cards setting does not need to be enabled to process subscriptions via Woo Subscriptions.

The Issue an authorization on checkout, and capture later setting, if checked, merely places a hold on customers’ cards, instead of automatically capturing the funds. This allows you to manually capture the charge at a later time, such as when you ship their item(s). Please see this guide for more information.

WARNING: We suggest leaving the authorize and capture setting disabled unless you have a specific and well-justified use case in mind.

The Full bank statement setting shows how transactions with your store will appear on customers’ bank statements or in their online banking systems. This is called a “descriptor”, and it can be changed in the Stripe dashboard.

The Add customer order number to the bank statement setting can be used if you wish to also add the order number to the descriptor. Enabling this will also cause the Shortened customer bank statement setting to appear just below.

The Shortened customer bank statement setting shows the short form of your descriptor. Because descriptors are limited in length, and because the order number will take up some of that limit, this setting should show a shorter or abbreviated version of the full descriptor. This setting only applies to card and express checkout transactions, and is also managed in the Stripe dashboard.

Lastly, the Payments & Transactions section will show a preview of your full-length and shortened bank statement descriptors:

Advanced settings section

↑ Back to top

The Advanced settings section of the Stripe WooCommerce Extension settings will allow you to enable additional, optional settings.

In the Advanced settings section, you can enable:

  1. Logging of error messages and information sent to Stripe’s servers.
    • This will save errors to a log file.
    • Normally, debugging isn’t necessary to have enabled, but a Happiness Engineer may ask you to enable debug mode.
    • You can view the logs by:
      1. From your site admin, head to WooCommerce > Status > Logs.
      2. Find the latest source named woocommerce-gateway-stripe.
      3. Select that source to view any errors from that day.
    • By default, logs will be stored for 30 days. Once the debug logs are older than 30 days, they will be automatically deleted.
  2. The new checkout experience, which will allow customers to choose their preferred payment method via a condensed UI.