WooPayments: Settings Guide

Spanish version of this page |  Aquí puedes encontrar la versión en español de esta página

WooPayments is designed to be fairly straightforward and intuitive to use. However, there are still some settings that each merchant will want to configure to their liking. This page is intended to explain in detail what each option does and how it might be used.

The WooPayments settings can be found under Payments > Settings.

This section contains some basic options that likely won’t need to be changed very often.

Unchecking this option will make it so that WooPayments is no longer offered as a payment method during checkout. This means that, if the box is unchecked, customers will not be able to pay via WooPayments.

What this setting does not do is disable the WooPayments plugin entirely. In other words, even with this box unchecked, you will still be able to access the Payouts, Transactions and Disputes pages, as well as issue refunds and so on.

If you want to completely disable the WooPayments plugin, please see this page.

Check this box to enable test mode. Test mode lets you try out payments, refunds, disputes and other such processes as you’re working on your store without handling live payment information. Unchecking this box disables test mode and switches your site into live mode, meaning that it will accept real payment methods and actually charge your customers.

Please see our Testing WooPayments page for details on how to use test mode.

This section allows you to add and edit the payment methods that customers can use to complete purchases on your site.

By checking the boxes in this section, you can also offer additional payment methods to certain customers. Offering these payment options can increase the chances that visitors to your site will purchase from your store.

This section contains buy now, pay later payment (BNPL) methods. These can help boost sales by offering customers more buying power and flexible payment options.

Please see our BNPL documentation to learn more about these payment methods.

This section controls which express checkouts are used on your site and how they look.

Express checkout methods are so named because they allow customers to check out faster than if the customer had not used one of these methods. WooPayments has the following express checkout methods built in:

• Apple Pay
• Google Pay
• Link by Stripe
• WooPay

Please see the links above for more info on each method and its settings.

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 card info to their account on your site, which allows them to check out much faster if they make more purchases from you in the future.

The Issue an authorization on checkout, and capture later setting, if checked, prevents WooPayments from automatically capturing charges. This allows you to manually capture the charge at a later time, such as when you ship the item.

If you enable this, it’s important to know that you will need to capture each order within 7 days of it being placed. Otherwise, the authorization and the order itself will be cancelled, and the funds will be returned to the customer.

The Customer bank statement setting controls how charges from your store appear on bank statements or in online banking systems.

By default, WooPayments will use the site URL for the statement descriptor. In the event that no statement descriptor is available, WooPayments will be used. You can learn more about the default WooPayments statement descriptor here.

You can change the statement descriptor if need be, but it must adhere to these rules:

• Contain only Latin characters.
  • Japanese merchants will also see descriptor fields for kanji and kana.
• Contain between 5 and 22 characters, inclusive.
• Contain at least one letter.
• Not contain any of these characters: < > \ ' " *
• Reflect your business name clearly.

Please see this page for more details on recommended statement descriptors.

The Support email and Support phone number settings determine what contact information is shown on receipts, invoices, and automated emails from your store.

We strongly suggest filling these settings out, since they can help prevent disputes from customers who might otherwise have trouble contacting your for assistance. If you don’t have a dedicated support email or phone number, we still recommend adding something here, even if it’s a personal email or phone number.

The Payouts section controls how often WooPayments pays out money from incoming orders into your linked bank account or debit card.

This setting allows you to specify a payout schedule that works best for your business. You can find more information on the options in our dedicated payout schedule document.

If it’s been less than 7 days since your first transaction with WooPayments, you will not be able to change your payout schedule until the initial 7 day waiting period has passed.

Your bank account or debit card details are securely stored and managed with our payments partner, Stripe. You can use the link in this section to access the Stripe dashboard, through which you can view and update your bank account or debit card information, if need be.

Our Fraud protection feature offers rules which you can use to block suspicious orders before they get placed. This can help you avoid carding attacks and increased disputes.

In short, when an order is placed, the fraud protection engine will evaluate that order according to the risk level you’ve selected here. Depending on your configuration, the order can either be allowed as normal or blocked outright.

We suggest that most sites use the Basic risk level, but you can optionally use the Advanced setting to configure specific fraud protection rules to best suit your business type, risk tolerance, and other factors. To learn more, please consult our dedicated page.

If your site language is set to something other than English (United States), you will be able to specify here what language you would like to use when exporting WooPayments reports.

The Advanced settings section gives you further flexibility in managing your WooPayments configuration. While you may not interact with these settings regularly, you can find them at the bottom of the settings page.

Enabling this lets you to accept payments from customers in currencies besides your shop currency. Please see our docs on accepting multiple currencies for more information.

This setting is only shown if you have Woo Subscriptions activated in addition to WooPayments. If you have both, you can choose between the on-site billing engine provided by Woo Subscriptions, or the off-site engine powered by Stripe Billing.

Please see our Stripe Billing document for full details on this feature.

With this option enabled, WooPayments will write debugging information to a log file. During normal operations, this is not necessary, but our support staff may direct you to enable debug mode if you contact us about an issue with WooPayments.

To view the log files and send them to us:

1. Go to WooCommerce > Status > Logs in your site’s dashboard.
2. Use the dropdown to find a log beginning with woopayments- and a date.
   • For example, to find the log file created on March 8, 2023, use the dropdown to search for a log file named woopayments-2023-03-08.
3. Once you’ve selected a log, click the View button to load it.
4. Select the entire log contents and copy it to the clipboard.
5. Open a new text file on your computer and paste the log contents in.
6. Attach that file to your email response to our support staff.

After the relevant issue has been resolved, feel free to disable debug mode again.

If you use WooPayments to accept In-Person Payments, a new menu item will appear under Payments in your dashboard: Payments > Card Readers. This page contains some settings related to any card readers you have purchased.

After each successful transaction, your customer will automatically be emailed a receipt. You will also have the option to issue a printed receipt through the WooCommerce mobile app. Certain details of these receipts can be customized under the Receipt details tab.

You can also use the Preview a printed receipt link to see a preview of how the printed receipt will look.