Settings Guide

After you’ve connected to Stripe and have webhooks working, you can begin using the Stripe extension. However, you may also want to adjust some of the settings in order to configure the plugin in a way that best suits your store.

This guide will walk you through the Stripe extension settings, which are shown under WooCommerce > Settings > Payments > Stripe > Settings in your WordPress dashboard. The page is broken down into four sections:

• General
• Account details
• Payments & transactions
• Advanced settings

This section controls if and how the Stripe payment option is presented to customers.

The Enable Stripe setting determines whether or not the Stripe extension payment methods are shown in checkout. What this setting does not do is disable the Stripe extension. To do that, you can disable the plugin itself.

The Enable test mode box controls if test mode is enabled or not. Unless you’re testing payments, refunds, disputes, or other such processes, and you are somehow preventing real customers from completing purchases, this should likely be disabled.

This section shows the status of your Stripe account as well as the status of the connection between that account and the Stripe extension.

Ideally, the Payment and Payout statuses should be “Enabled.” If they aren’t, then Stripe may have restricted your payments or payouts for some reason. You’ll need to consult the Stripe dashboard for more information in such cases.

Similarly, the Webhook status should also say “Enabled.” If it does not, it means you either have not connected to Stripe at all yet, or you connected prior to version 8.6.1, and you still need to re-authenticate.

By clicking the Configure connection button, you can see the status of the connection between your Stripe account and the Stripe extension on your site.

If the Stripe extension is properly connected to your Stripe account, the Account status should be “Connected” and the Webhooks status should be “Configured.” If they say anything else (e.g. “Incomplete”), you may need to re-authenticate your connection.

Note the tabs in the pop: Live and Test. Using them, you can check the Account and Webhooks statuses for each mode. Because each mode is configured separately, it’s possible to be connected to live mode but not to test mode, or vice versa.

Lastly, if you’d like to disconnect the Stripe extension from your Stripe account, you can do so by clicking the three dots, and then Disconnect.

This section contains a settings related to how transactions function on your site, and how they appear to customers in emails, receipts, and bank statements.

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
• Bancontact
• iDEAL
• SEPA Direct Debit

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 the order. We strongly suggest reading this page before enabling this setting.

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:

This section shows a few additional settings that you shouldn’t need to change very often.

After you enable the Log error messages setting, the Stripe extension will start logging all activity to the WooCommerce logger. This option should only be enabled if you’re troubleshooting the Stripe extension.

The Enable the legacy checkout experience option, if checked, turns on the legacy checkout. We strongly suggest leaving this option disabled.