notices[ $slug ] = [
'class' => $class,
'message' => $message,
'dismissible' => $dismissible,
'actions' => $actions,
'css_rules' => $css_rules,
];
}
/**
* Display any notices we've collected thus far.
*
* @since 1.0.0
* @version 4.0.0
*
* @return void
*/
public function admin_notices() {
if ( ! current_user_can( 'manage_woocommerce' ) ) {
return;
}
// Stripe API outage detection. Runs first so other environment checks
// can suppress notices that would be misleading during an outage.
$this->check_api_outage();
// Main Stripe payment method.
$this->stripe_check_environment();
// All other payment methods.
$this->payment_methods_check_environment();
// Check for merchants affected by ECE button location bug.
// https://github.com/woocommerce/woocommerce-gateway-stripe/issues/4861
$this->check_express_checkout_location();
// "Now active" notices for the OCS + Adaptive Pricing 10.8 default-on rollout.
$this->check_ocs_ap_update_notices();
// Check for subscriptions detached from the customer.
if ( WC_Stripe_Subscriptions_Helper::is_subscriptions_enabled() ) {
$this->subscription_check_detachment();
$this->subscription_check_detachment_bulk_action();
}
foreach ( (array) $this->notices as $notice_key => $notice ) {
$actions = $notice['actions'] ?? [];
$div_style = 'position:relative;';
$has_actions = count( $actions ) > 0;
if ( $has_actions ) {
// If there are actions, we need to make sure the div can contain them.
$div_style .= 'overflow: auto;';
}
if ( is_array( $notice['css_rules'] ?? null ) && [] !== $notice['css_rules'] ) {
echo '';
}
echo '';
if ( $notice['dismissible'] ) {
?>
';
echo wp_kses(
$notice['message'],
[
'a' => [
'href' => [],
'target' => [],
],
'strong' => [],
'br' => [],
'img' => [
'src' => [],
'alt' => [],
'style' => [],
],
]
);
echo '';
if ( $has_actions ) {
foreach ( $actions as $action ) {
echo wp_kses(
$action,
[
'a' => [
'class' => [],
'href' => [],
'style' => [],
'target' => [],
],
]
);
}
}
echo '
', 'woocommerce-gateway-stripe' ), $upe_method->get_label(), implode( ', ', $upe_method->get_supported_currencies() ) );
}
}
$show_notice = get_option( 'wc_stripe_show_upe_payment_methods_notice' );
if ( ! empty( $currency_messages ) && 'no' !== $show_notice ) {
$this->add_admin_notice( 'upe_payment_methods', 'notice notice-error', $currency_messages, true );
}
}
/**
* Checks if the merchant may have been affected by the ECE button location bug
* in versions 10.1.0–10.2.x and displays a notice if so.
*
* @since 10.4.0
*
* @return void
*/
public function check_express_checkout_location(): void {
$show_notice = get_option( 'wc_stripe_show_ece_location_notice' );
if ( 'yes' !== $show_notice ) {
return;
}
$options = WC_Stripe_Helper::get_stripe_settings();
$enabled = isset( $options['express_checkout'] ) && 'yes' === $options['express_checkout'];
$locations = isset( $options['express_checkout_button_locations'] ) ? $options['express_checkout_button_locations'] : [];
if ( ! $enabled ) {
return;
}
$has_product = in_array( 'product', $locations, true );
$has_cart = in_array( 'cart', $locations, true );
$has_checkout = in_array( 'checkout', $locations, true );
// We only need to show the notice if we have ( product + cart ) but not checkout, so return if we have anything else.
if ( ! ( $has_product && $has_cart && ! $has_checkout ) ) {
return;
}
$settings_url = admin_url( 'admin.php?page=wc-settings&tab=checkout§ion=stripe&panel=methods&area=express_checkout' );
$message = sprintf(
/* translators: 1) HTML strong open tag 2) HTML strong closing tag 3) HTML line break tag */
__( '%1$sAction Required: Review your Stripe express checkout settings.%2$s%3$sA recent update to the Stripe plugin may have unintentionally changed where Apple Pay and Google Pay buttons appear. Currently, they are active on the product and cart pages but not on the checkout page. Please review your express checkout settings to ensure your customers have the best checkout experience.', 'woocommerce-gateway-stripe' ),
'',
'',
'
'
);
$review_action = sprintf(
'%s',
esc_url( $settings_url ),
__( 'Review Settings', 'woocommerce-gateway-stripe' )
);
$this->add_admin_notice( 'ece_location', 'notice notice-warning', $message, true, [ $review_action ] );
}
/**
* Surfaces the "now active" notices for the OCS + Adaptive Pricing 10.8
* default-on rollout.
*
* The visibility options are written once by {@see WC_Stripe_OCS_AP_Default_On_Update}
* at upgrade time, which guarantees they are mutually exclusive.
*
* Shown across all WooCommerce admin screens so the message reaches merchants
* who never open the Stripe settings page.
*
* @since 10.8.0
*
* @return void
*/
public function check_ocs_ap_update_notices(): void {
$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
if ( ! $screen || ! function_exists( 'wc_get_screen_ids' ) || ! in_array( $screen->id, wc_get_screen_ids(), true ) ) {
return;
}
$gateway = WC_Stripe::get_instance()->get_main_stripe_gateway();
$is_oc_enabled = $gateway->is_oc_enabled();
$is_ap_enabled = 'yes' === $gateway->get_option( 'adaptive_pricing' );
$is_india = 'IN' === WC_Stripe::get_instance()->account->get_account_country();
$css_rules = [
'.notice.wc-stripe-ocs-ap-notice p { padding-top: 1.25em; }',
];
$notice_class = 'notice notice-info wc-stripe-ocs-ap-notice';
$stripe_logo_image = ' . ')
';
$learn_more_action = sprintf(
'%s',
esc_url( self::OCS_AP_PRODUCT_UPDATE_URL ),
esc_html__( 'Learn more ↗', 'woocommerce-gateway-stripe' )
);
$review_action = sprintf(
'%s',
$this->get_setting_link(),
esc_html__( 'Review settings', 'woocommerce-gateway-stripe' )
);
// Don't include Review setting link when on the Stripe settings page.
$is_stripe_settings_page = isset( $_GET['page'], $_GET['section'], $_GET['panel'] ) && 'wc-settings' === $_GET['page'] && 'stripe' === $_GET['section'] && 'settings' === $_GET['panel'];
if ( $is_stripe_settings_page ) {
$actions = [ $learn_more_action ];
} else {
$actions = [ $review_action, $learn_more_action ];
}
if ( $is_oc_enabled && $is_ap_enabled && ! $is_india && 'yes' === get_option( self::SHOW_OCS_AP_BANNER_OPTION, 'no' ) ) {
$message = sprintf(
/* translators: 1) Image tag 2) HTML strong open tag 3) HTML strong closing tag 4) HTML line break tag */
__( '%1$s%2$sStripe Optimized Checkout Suite and Adaptive Pricing are now active%3$s%4$sYour checkout dynamically displays available payment methods most likely to drive conversions. International shoppers also see prices in their local currency, growing cross-border revenue by an average of 17.8%%.%4$s*Data is from Stripe global holdback study conducted in 2024', 'woocommerce-gateway-stripe' ),
$stripe_logo_image,
'',
'',
'
'
);
$this->add_admin_notice( 'ocs_ap_banner', $notice_class, $message, true, $actions, $css_rules );
return;
}
if ( $is_oc_enabled && $is_ap_enabled && ! $is_india && 'yes' === get_option( self::SHOW_AP_ONLY_BANNER_OPTION, 'no' ) ) {
$message = sprintf(
/* translators: 1) Image tag 2) HTML strong open tag 3) HTML strong closing tag 4) HTML line break tag */
__( "%1\$s%2\$sStripe Adaptive Pricing is now active%3\$s%4\$sYour checkout now shows prices in shoppers' local currency across 150+ countries, growing cross-border revenue by an average of 17.8%%. Stripe handles real-time exchange rates with no currency conversion fees.%4\$s*Data is from Stripe global holdback study conducted in 2024", 'woocommerce-gateway-stripe' ),
$stripe_logo_image,
'',
'',
'
'
);
$this->add_admin_notice( 'ap_only_banner', $notice_class, $message, true, $actions, $css_rules );
return;
}
if ( $is_oc_enabled && ! $is_ap_enabled && 'yes' === get_option( self::SHOW_OCS_ONLY_BANNER_OPTION, 'no' ) ) {
$message = sprintf(
/* translators: 1) Image tag 2) HTML strong open tag 3) HTML strong closing tag 4) HTML line break tag */
__( "%1\$s%2\$sStripe Optimized Checkout is now active%3\$s%4\$sYour checkout is optimized for sales by dynamically displaying the most relevant payment methods you've enabled for each customer.", 'woocommerce-gateway-stripe' ),
$stripe_logo_image,
'',
'',
'
'
);
$this->add_admin_notice( 'ocs_only_banner', $notice_class, $message, true, $actions, $css_rules );
return;
}
}
/**
* Adds a notice to the subscription details page if we are looking at an active subscription and the payment method has been detached.
*
* @return void
*/
public function subscription_check_detachment() {
if ( ! WC_Stripe_Subscriptions_Helper::is_subscription_edit_page() ) {
return;
}
global $theorder;
$subscription = null;
if ( isset( $theorder ) ) {
$subscription = $theorder;
} elseif ( ! empty( $GLOBALS['post']->ID ) ) { // If $theorder is empty (i.e. non-HPOS), fallback to using the global post object.
$subscription = wcs_get_subscription( $GLOBALS['post']->ID );
}
if ( ! isset( $subscription ) || ! $subscription instanceof WC_Subscription ) {
return;
}
if ( ! $subscription->has_status( [ 'active' ] ) ) {
// Only show the notice for active subscriptions.
return;
}
// If not detached but the user dismissed the notice prior, clear the meta so it can show if later detached.
if ( ! WC_Stripe_Subscriptions_Helper::is_subscription_payment_method_detached( $subscription ) ) {
if ( $subscription->get_meta( self::DETACHED_NOTICE_DISMISSED_META ) ) {
$subscription->delete_meta_data( self::DETACHED_NOTICE_DISMISSED_META );
$subscription->save_meta_data();
}
return;
}
if ( 'yes' === $subscription->get_meta( self::DETACHED_NOTICE_DISMISSED_META ) ) {
return;
}
$customer_payment_method_link = sprintf(
'%s',
esc_url( $subscription->get_change_payment_method_url() ),
esc_html(
/* translators: this is a text for a link pointing to the customer's payment method page */
__( 'Payment method page →', 'woocommerce-gateway-stripe' )
)
);
$customer_stripe_page = sprintf(
'%s',
esc_url( WC_Stripe_Subscriptions_Helper::STRIPE_CUSTOMER_PAGE_BASE_URL . WC_Stripe_Order_Helper::get_instance()->get_stripe_customer_id( $subscription ) ),
esc_html(
/* translators: this is a text for a link pointing to the customer's page on Stripe */
__( 'Stripe customer page →', 'woocommerce-gateway-stripe' )
)
);
$detached_message = __( 'The payment method for this subscription has been detached, preventing renewals. ', 'woocommerce-gateway-stripe' );
$detached_message .= __( 'To fix this, either:
', 'woocommerce-gateway-stripe' );
$detached_message .= __( '1) Share the payment method page link with the customer to update it: ', 'woocommerce-gateway-stripe' ) . $customer_payment_method_link . '
';
$detached_message .= __( ' or
', 'woocommerce-gateway-stripe' );
$detached_message .= __( "2) Manually update the payment method in the subscription's billing details using a valid payment method from the customer's Stripe account: ", 'woocommerce-gateway-stripe' ) . $customer_stripe_page . '
';
$detached_message .= '
' . sprintf(
/* translators: 1) HTML anchor open tag 2) HTML anchor closing tag 3) The already-translated title of the tool*/
__( 'To list all your current subscriptions with payment methods detached, go to WooCommerce -> Status -> %1$sTools%2$s -> %3$s.', 'woocommerce-gateway-stripe' ),
'',
'',
__( 'List Stripe subscriptions with detached payment method', 'woocommerce-gateway-stripe' ),
);
$this->add_admin_notice( 'subscription_detached', 'notice notice-error', $detached_message, true );
}
/**
* Add a notice to the admin area if there are subscriptions with payment method detached.
*
* @return void
*/
public function subscription_check_detachment_bulk_action() {
if ( isset( $_REQUEST['detached-subscriptions'] ) && 'no' !== get_option( 'wc_stripe_show_subscription_detached_bulk_action_notice' ) ) {
$notice_content = '' . esc_html__( 'No detached subscriptions found.', 'woocommerce-gateway-stripe' ) . '
';
$notice_class = 'info';
if ( ! empty( $_REQUEST['detached-subscriptions'] ) ) {
$detached_subs_ids = explode( ',', sanitize_text_field( wp_unslash( $_REQUEST['detached-subscriptions'] ) ) );
$subscriptions = [];
foreach ( $detached_subs_ids as $detached_sub_id ) {
$detached_sub_id = absint( $detached_sub_id );
$subscription = wcs_get_subscription( $detached_sub_id );
if ( ! $subscription instanceof WC_Subscription ) {
continue;
}
$subscriptions[] = WC_Stripe_Subscriptions_Helper::get_detached_payment_data_from_subscription( $subscription );
}
$detached_messages = WC_Stripe_Subscriptions_Helper::build_subscriptions_detached_messages( $subscriptions );
if ( ! empty( $detached_messages ) ) {
$notice_content = '';
$notice_content .= wp_kses(
$detached_messages,
[
'a' => [
'href' => [],
'target' => [],
],
'strong' => [],
'br' => [],
]
);
$notice_content .= '
';
$notice_class = 'error';
}
}
$this->add_admin_notice( 'subscription_detached_bulk_action', 'notice notice-' . $notice_class, $notice_content, true );
}
}
/**
* Hides any admin notices.
*
* @since 4.0.0
* @version 4.0.0
*
* @return void
*/
public function hide_notices() {
if ( isset( $_GET['wc-stripe-hide-notice'] ) && isset( $_GET['_wc_stripe_notice_nonce'] ) ) {
if ( ! wp_verify_nonce( wc_clean( wp_unslash( $_GET['_wc_stripe_notice_nonce'] ) ), 'wc_stripe_hide_notices_nonce' ) ) {
wp_die( esc_html__( 'Action failed. Please refresh the page and retry.', 'woocommerce-gateway-stripe' ) );
}
if ( ! current_user_can( 'manage_woocommerce' ) ) {
wp_die( esc_html__( 'Cheatin’ huh?', 'woocommerce-gateway-stripe' ) );
}
$notice = wc_clean( wp_unslash( $_GET['wc-stripe-hide-notice'] ) );
switch ( $notice ) {
case 'style':
update_option( 'wc_stripe_show_style_notice', 'no' );
break;
case 'phpver':
update_option( 'wc_stripe_show_phpver_notice', 'no' );
break;
case 'wcver':
update_option( 'wc_stripe_show_wcver_notice', 'no' );
break;
case 'curl':
update_option( 'wc_stripe_show_curl_notice', 'no' );
break;
case 'ssl':
update_option( 'wc_stripe_show_ssl_notice', 'no' );
break;
case 'keys':
update_option( 'wc_stripe_show_keys_notice', 'no' );
break;
case '3ds':
update_option( 'wc_stripe_show_3ds_notice', 'no' );
break;
case 'sofort':
update_option( 'wc_stripe_show_sofort_notice', 'no' );
update_option( 'wc_stripe_show_sofort_upe_notice', 'no' );
break;
case 'sca':
update_option( 'wc_stripe_show_sca_notice', 'no' );
break;
case 'changed_keys':
update_option( 'wc_stripe_show_changed_keys_notice', 'no' );
break;
case 'legacy_deprecation':
update_option( 'wc_stripe_show_legacy_deprecation_notice', 'no' );
break;
case 'payment_methods':
update_option( 'wc_stripe_show_payment_methods_notice', 'no' );
break;
case 'upe_payment_methods':
update_option( 'wc_stripe_show_upe_payment_methods_notice', 'no' );
break;
case 'oauth_required':
update_option( 'wc_stripe_show_oauth_required_notice', 'no' );
break;
case 'subscriptions':
update_option( 'wc_stripe_show_subscriptions_notice', 'no' );
break;
case 'subscription_detached':
// Non-HPOS uses `post`, HPOS uses `id` in URL query string to store post ID.
$subscription_id = 0;
if ( isset( $_REQUEST['post'] ) ) {
$subscription_id = absint( wp_unslash( $_REQUEST['post'] ) );
} elseif ( isset( $_REQUEST['id'] ) ) {
$subscription_id = absint( wp_unslash( $_REQUEST['id'] ) );
}
if ( $subscription_id > 0 ) {
$subscription = wcs_get_subscription( $subscription_id );
if ( $subscription instanceof WC_Subscription ) {
$subscription->update_meta_data( self::DETACHED_NOTICE_DISMISSED_META, 'yes' );
$subscription->save_meta_data();
}
}
if ( isset( $_SERVER['REQUEST_URI'] ) ) {
wp_safe_redirect( remove_query_arg( [ 'wc-stripe-hide-notice', '_wc_stripe_notice_nonce' ], esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) );
}
break;
case 'subscription_detached_bulk_action':
update_option( 'wc_stripe_show_subscription_detached_bulk_action_notice', 'no' );
// Redirect back to the current page without the query param to hide the notice to avoid issues.
if ( isset( $_SERVER['REQUEST_URI'] ) ) {
wp_safe_redirect( remove_query_arg( [ 'wc-stripe-hide-notice', '_wc_stripe_notice_nonce' ], esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) );
}
break;
case 'ece_location':
update_option( 'wc_stripe_show_ece_location_notice', 'no' );
break;
case 'ocs_ap_banner':
update_option( self::SHOW_OCS_AP_BANNER_OPTION, 'no' );
break;
case 'ap_only_banner':
update_option( self::SHOW_AP_ONLY_BANNER_OPTION, 'no' );
break;
case 'ocs_only_banner':
update_option( self::SHOW_OCS_ONLY_BANNER_OPTION, 'no' );
break;
}
}
}
/**
* Get setting link.
*
* @since 1.0.0
*
* @return string Setting link
*/
public function get_setting_link() {
return esc_url( admin_url( 'admin.php?page=wc-settings&tab=checkout§ion=stripe&panel=settings' ) );
}
/**
* Saves options in order to hide notices based on the gateway's version.
*
* @since 4.3.0
*
* @return void
*/
public function stripe_updated() {
wc_deprecated_function( __METHOD__, '10.8.0', 'WC_Stripe_Admin_Notices::check_update_notices()' );
self::check_update_notices( get_option( 'wc_stripe_version' ) );
}
/**
* Check for any notices to display after an update.
*
* @param string $previous_version The previous version of the plugin.
*
* @since 10.8.0
*
* @return void
*/
public static function check_update_notices( $previous_version ): void {
// Only show the style notice if the plugin was installed and older than 4.1.4.
if ( empty( $previous_version ) || version_compare( $previous_version, '4.1.4', 'ge' ) ) {
update_option( 'wc_stripe_show_style_notice', 'no' );
}
// Only show the SCA notice on pre-4.3.0 installs.
if ( empty( $previous_version ) || version_compare( $previous_version, '4.3.0', 'ge' ) ) {
update_option( 'wc_stripe_show_sca_notice', 'no' );
}
// Set the ECE location notice flag if upgrading from the affected version range (10.1.0–10.2.x).
// A bug in these versions reset express checkout button locations during upgrade.
$was_affected_version = ! empty( $previous_version )
&& version_compare( $previous_version, '10.1.0', '>=' )
&& version_compare( $previous_version, '10.4.0', '<' );
if ( $was_affected_version && 'no' !== get_option( 'wc_stripe_show_ece_location_notice' ) ) {
update_option( 'wc_stripe_show_ece_location_notice', 'yes' );
}
}
}