Safe Mode helps to prevent issues in cases where duplicate sites are connected to the same WooCommerce Payments connection. You’ll know your site is in Safe Mode when you see the following:
When does Safe Mode happen? ↑ Back to top
Safe Mode is activated when your site address (URL) changes for one of the following reasons:
- You bought a new domain name and update your site to use that domain.
- You clone your site from production to staging.
- You allow two URLs to point to the same WordPress installation.
- Any other scenario where the URL of your site might change.
Safe Mode can also occur when using certain uncommon website configurations, Most often, this happens when your site was created with Bitnami, Amazon Lightsail, or on sites with multiple web servers running behind a load balancer. See below for the solution for these.
What potential issues could Safe Mode cause WooCommerce Payments? ↑ Back to top
When Safe Mode is active, payments will not be interrupted. In other words, your customers can still finish checkout on your site with WooCommerce Payments.
However, some features may not be available as well reliable until you solve this issue:
- Dispute and refund updates.
- Payment confirmations for some alternative payment methods such as Sofort and SEPA.
What does each button do? ↑ Back to top
Under the hood, WooCommerce Payments uses the Jetpack connection (but not the whole Jetpack plugin) for its operation such as getting payments, retrieving data including transactions, deposits, disputes, etc.
This document only deals with WooCommerce Payments, so if your site also has the Jetpack plugin active, refer to its documentation for similar implications related to Jetpack data like stats and subscribers.
The Safe Mode notice (pictured above), offers two buttons:
Transfer your connection ↑ Back to top
Clicking this option moves all WooCommerce Payments data to the current site, including your account information, history of transactions, deposits, payments, etc.
The other site will be disconnected from WooCommerce Payments.
Create a new connection ↑ Back to top
If you click this option, you’ll have to re-verify your business details to begin accepting payments for your current site.
The other site will continue using WooCommerce Payments without any change.
Dynamic Site URLs ↑ Back to top
In some cases, the WooCommerce Payments can be sent into Safe Mode when the WordPress site URL is defined in a “dynamic” way. This most often happens when sites have been created by Bitnami, or are hosted on Amazon Lightsail, or are running on multiple web servers behind a load balancer.
To determine if this applies to you, check your
wp-config.php file for the presence code similar to this:
define( 'WP_SITEURL', 'http://' . $_SERVER['HTTP_HOST'] . '/' ); define( 'WP_HOME', 'http://' . $_SERVER['HTTP_HOST'] . '/' );
If that code is present, you’ll want to remove it and replace it with this code instead:
define( 'WP_SITEURL', 'https://www.example.com' ); define( 'WP_HOME', 'https://www.example.com' );
Be sure to swap out the example domain with your site’s actual domain.
Making this change in your
wp-config.php file will ideally prevent the site from being placed into Safe Mode in the future.