Fee Taxes - provide a way for the merchant to enter Tax ID ahead of release (#10859)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Dat Hoang <htdat@users.noreply.github.com>

Author: 3 people

changelog/woopmnt-5055-fee-taxes-provide-a-way-for-the-merchant-to-enter-tax-id

@@ -0,0 +1,4 @@
+Significance: minor
+Type: add
+
+Added a URL parameter to allow merchants to access the VAT details modal.

client/settings/settings-manager/index.js

@@ -2,10 +2,11 @@
 /**
  * External dependencies
  */
-import React, { useState, useLayoutEffect, useEffect } from 'react';
+import React, { useState, useEffect, useLayoutEffect } from 'react';
 import { ExternalLink } from '@wordpress/components';
 import { __, sprintf } from '@wordpress/i18n';
-import { getQuery } from '@woocommerce/navigation';
+import { getQuery, updateQueryString } from '@woocommerce/navigation';
+import { dispatch } from '@wordpress/data';
 
 /**
  * Internal dependencies
@@ -29,6 +30,7 @@ import {
 } from '../../data';
 import FraudProtection from '../fraud-protection';
 import DuplicatedPaymentMethodsContext from './duplicated-payment-methods-context';
+import VatFormModal from '../../vat/form-modal';
 import './style.scss';
 
 const ExpressCheckoutDescription = () => (
@@ -185,6 +187,36 @@ const SettingsManager = () => {
 		dismissedDuplicateNotices,
 		setDismissedDuplicateNotices,
 	] = useState( wcpaySettings.dismissedDuplicateNotices || {} );
+	const [ isVatFormModalOpen, setVatFormModalOpen ] = useState( false );
+
+	useEffect( () => {
+		const urlParams = new URLSearchParams( window.location.search );
+		if ( urlParams.get( 'woopayments-vat-details-modal' ) === 'true' ) {
+			if ( ! wcpaySettings.accountStatus.hasSubmittedVatData ) {
+				setVatFormModalOpen( true );
+			} else {
+				dispatch( 'core/notices' ).createInfoNotice(
+					__(
+						'Tax details are already submitted.',
+						'woocommerce-payments'
+					)
+				);
+			}
+		}
+	}, [] );
+
+	const handleVatFormModalClose = () => {
+		setVatFormModalOpen( false );
+		// Remove the URL parameter when the modal is closed.
+		updateQueryString( { 'woopayments-vat-details-modal': undefined } );
+	};
+
+	const handleVatFormModalCompleted = () => {
+		dispatch( 'core/notices' ).createInfoNotice(
+			__( 'Tax details updated', 'woocommerce-payments' )
+		);
+		handleVatFormModalClose();
+	};
 
 	return (
 		<SettingsLayout>
@@ -262,6 +294,11 @@ const SettingsManager = () => {
 				</LoadableSettingsSection>
 			</SettingsSection>
 			<SaveSettingsSection disabled={ ! isTransactionInputsValid } />
+			<VatFormModal
+				isModalOpen={ isVatFormModalOpen }
+				setModalOpen={ handleVatFormModalClose }
+				onCompleted={ handleVatFormModalCompleted }
+			/>
 		</SettingsLayout>
 	);
 };

includes/class-wc-payments-vat-redirect-service.php

@@ -0,0 +1,54 @@
+<?php
+/**
+ * WooCommerce Payments VAT Redirect Service.
+ *
+ * @package WooCommerce\Payments
+ */
+
+namespace WCPay;
+
+defined( 'ABSPATH' ) || exit; // block direct access.
+
+/**
+ * Service class for handling VAT details redirect functionality.
+ *
+ * @todo This is a temporary solution that will be replaced by a dedicated VAT settings section.
+ *       Remove this class when the permanent solution is implemented.
+ */
+class WC_Payments_VAT_Redirect_Service {
+
+	/**
+	 * Initialize hooks.
+	 *
+	 * @return void
+	 */
+	public function init_hooks(): void {
+		add_action( 'template_redirect', [ $this, 'maybe_redirect' ], 1 );
+	}
+
+	/**
+	 * Handles redirection to VAT details modal if needed.
+	 *
+	 * @return void
+	 */
+	public function maybe_redirect(): void {
+		// phpcs:disable WordPress.Security.NonceVerification.Recommended
+		if ( ! isset( $_GET['woopayments-vat-details-redirect'] ) ) {
+			return;
+		}
+		// phpcs:enable WordPress.Security.NonceVerification.Recommended
+
+		// skip REST API calls.
+		if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) {
+			return;
+		}
+
+		// skip AJAX requests.
+		if ( function_exists( 'wp_doing_ajax' ) && wp_doing_ajax() ) {
+			return;
+		}
+
+		wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=checkout&section=woocommerce_payments&woopayments-vat-details-modal=true' ) );
+		exit;
+	}
+}

woocommerce-payments.php

@@ -169,6 +169,11 @@ function wcpay_init() {
 	 */
 	\WCPay\WooPay\WooPay_Session::init();
 	( new WC_Payments_Payment_Request_Session() )->init();
+
+	// @todo This is a temporary solution that will be replaced by a dedicated VAT settings section.
+	// Remove this initialization when the permanent solution is implemented.
+	require_once WCPAY_ABSPATH . '/includes/class-wc-payments-vat-redirect-service.php';
+	( new \WCPay\WC_Payments_VAT_Redirect_Service() )->init_hooks();
 }
 
 // Make sure this is run *after* WooCommerce has a chance to initialize its packages (wc-admin, etc). That is run with priority 10.