# multisafepay/trunk/src/Main.php

MultiSafepay plugin for WooCommerce, version trunk. 275 lines.

- Page: https://pluginprobe.com/plugins/multisafepay/trunk/code/src/Main.php
- Raw: https://pluginprobe.com/plugins/multisafepay/trunk/raw/src/Main.php
- Modified: 2026-05-21T07:26:10+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/multisafepay/trunk/code/src/Main.php#L10-L20`.

```php
<?php declare(strict_types=1);

namespace MultiSafepay\WooCommerce;

use MultiSafepay\WooCommerce\Blocks\BlocksController;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\CancelOrderStatuses;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\CheckoutPaymentUrl;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\GatewayByCountry;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\GatewayByMinAmount;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\GatewayByUserRole;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\NonDuplicatedBrandedNames;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\PaymentGatewaysRegistration;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\PaymentMethodTitle;
use MultiSafepay\WooCommerce\PaymentMethods\Filters\TransactionOrderId;
use MultiSafepay\WooCommerce\PaymentMethods\PaymentMethodsController;
use MultiSafepay\WooCommerce\Services\PaymentComponentService;
use MultiSafepay\WooCommerce\Services\PostepayMigrationService;
use MultiSafepay\WooCommerce\Services\Qr\QrPaymentComponentService;
use MultiSafepay\WooCommerce\Services\Qr\QrPaymentWebhook;
use MultiSafepay\WooCommerce\Services\ValidationService;
use MultiSafepay\WooCommerce\Settings\SettingsController;
use MultiSafepay\WooCommerce\Settings\ThirdPartyCompatibility;
use MultiSafepay\WooCommerce\Utils\CustomLinks;
use MultiSafepay\WooCommerce\Utils\Internationalization;
use MultiSafepay\WooCommerce\Utils\Loader;

/**
 * This class is the core of the plugin.
 * Is used to define internationalization, admin and front hooks.
 */
class Main {

    /**
     * The loader that's responsible for maintaining and registering all hooks
     *
     * @var Loader Maintains and registers all hooks for the plugin.
     */
    public $loader;

    /**
     * Define the core functionality of the plugin.
     *
     * Load the dependencies, define the locale, and set the hooks for the admin area and
     * the public face of the site.
     */
    public function __construct() {
        $this->loader = new Loader();
        $this->compatibilities();
        $this->set_locale();
        $this->custom_links_in_plugin_list();
        $this->settings_hooks();
        $this->block_hooks();
        $this->payment_methods_hooks();
        $this->payment_components_hooks();
        $this->payment_components_qr_hooks();
        $this->callback_hooks();
        $this->validation_hooks();
    }

    /**
     * Define compatibilities with third party plugins
     *
     * @return void
     */
    private function compatibilities(): void {
        $compatibilities = new ThirdPartyCompatibility();
        $this->loader->add_action( 'before_woocommerce_init', $compatibilities, 'declare_all_compatibilities' );
    }

    /**
     * Define the locale for this plugin for internationalization.
     *
     * Uses the Internationalization class in order to set the domain and register the hook
     * with WordPress.
     *
     * @return void
     */
    private function set_locale() {
        $plugin_i18n = new Internationalization();
        $this->loader->add_action( 'plugins_loaded', $plugin_i18n, 'load_plugin_textdomain' );
    }


    /**
     * Define the custom links in the plugin list
     *
     * @see https://developer.wordpress.org/reference/hooks/plugin_action_links_plugin_file/
     *
     * @return  void
     */
    private function custom_links_in_plugin_list(): void {
        $custom_links = new CustomLinks();
        $this->loader->add_filter( 'plugin_action_links_multisafepay/multisafepay.php', $custom_links, 'get_links' );
    }

    /**
     * Register the hooks related to the common settings
     * of the plugin.
     *
     * @return void
     */
    private function settings_hooks(): void {
        $plugin_settings = new SettingsController();

        // Filter get_option for some option names.
        $this->loader->add_filter( 'option_multisafepay_testmode', $plugin_settings, 'filter_multisafepay_settings_as_booleans' );
        $this->loader->add_filter( 'option_multisafepay_debugmode', $plugin_settings, 'filter_multisafepay_settings_as_booleans' );
        $this->loader->add_filter( 'option_multisafepay_second_chance', $plugin_settings, 'filter_multisafepay_settings_as_booleans' );
        $this->loader->add_filter( 'option_multisafepay_final_order_status', $plugin_settings, 'filter_multisafepay_settings_as_booleans' );
        $this->loader->add_filter( 'option_multisafepay_disable_shopping_cart', $plugin_settings, 'filter_multisafepay_settings_as_booleans' );
        $this->loader->add_filter( 'option_multisafepay_time_active', $plugin_settings, 'filter_multisafepay_settings_as_int' );

        if ( is_admin() ) {
            // Enqueue styles and JavaScript file in controller settings page
            $this->loader->add_action( 'admin_enqueue_scripts', $plugin_settings, 'enqueue_styles_and_scripts', 1 );
            // Add menu page for common settings page
            $this->loader->add_action( 'admin_menu', $plugin_settings, 'register_common_settings_page', 9 );
            // Add the new settings page the WooCommerce screen options
            $this->loader->add_filter( 'woocommerce_screen_ids', $plugin_settings, 'set_wc_screen_options_in_common_settings_page' );
            // Register settings
            $this->loader->add_action( 'admin_init', $plugin_settings, 'register_common_settings' );
            // Filter and return ordered the results of the fields
            $this->loader->add_filter( 'multisafepay_common_settings_fields', $plugin_settings, 'filter_multisafepay_common_settings_fields', 10, 1 );

            // Handle PostePay migration in the admin area
            $postepay_migration = new PostepayMigrationService();
            $this->loader->add_action( 'admin_init', $postepay_migration, 'postepay_migration', 5 );
        }
    }

    /**
     * Register the hooks related to the payment methods
     * of the plugin.
     *
     * @return void
     */
    private function payment_methods_hooks(): void {
        $this->payment_methods_filters_hooks();
        $this->payment_methods_actions_hooks( new PaymentMethodsController() );
    }

    /**
     * Register payment methods filter hooks.
     *
     * @return void
     */
    private function payment_methods_filters_hooks(): void {
        // Register the MultiSafepay payment gateways in WooCommerce.
        $this->loader->add_filter( 'woocommerce_payment_gateways', ( new PaymentGatewaysRegistration() ), 'get_woocommerce_payment_gateways' );
        // Filter transaction order id on callback
        $this->loader->add_filter( 'multisafepay_transaction_order_id', ( new TransactionOrderId() ), 'multisafepay_transaction_order_id', 11 );
        // Filter per country
        $this->loader->add_filter( 'woocommerce_available_payment_gateways', ( new GatewayByCountry() ), 'filter_gateway_per_country', 11 );
        // Filter per min amount
        $this->loader->add_filter( 'woocommerce_available_payment_gateways', ( new GatewayByMinAmount() ), 'filter_gateway_per_min_amount', 12 );
        // Filter per user role
        $this->loader->add_filter( 'woocommerce_available_payment_gateways', ( new GatewayByUserRole() ), 'filter_gateway_per_user_roles', 13 );
        // Filter duplicated branded payment methods
        $this->loader->add_filter( 'woocommerce_available_payment_gateways', ( new NonDuplicatedBrandedNames() ), 'filter_non_duplicated_branded_names', 14 );
        // Replace checkout payment url if a payment link has been generated in backoffice
        $this->loader->add_filter( 'woocommerce_get_checkout_payment_url', ( new CheckoutPaymentUrl() ), 'replace_checkout_payment_url', 10, 2 );
        // Allow cancel orders for on-hold status
        $this->loader->add_filter( 'woocommerce_valid_order_statuses_for_cancel', ( new CancelOrderStatuses() ), 'allow_cancel_multisafepay_orders_with_on_hold_status', 10, 2 );
        // Use the stored order payment method title in the admin order context
        if ( is_admin() && ! wp_doing_ajax() ) {
            $this->loader->add_filter( 'woocommerce_gateway_title', ( new PaymentMethodTitle() ), 'filter_gateway_title_by_order_payment_method_title', 10, 2 );
        }
    }

    /**
     * Register payment methods action hooks.
     *
     * @param PaymentMethodsController $payment_methods
     * @return void
     */
    private function payment_methods_actions_hooks( PaymentMethodsController $payment_methods ): void {
        // Enqueue styles in payment methods
        $this->loader->add_action( 'wp_enqueue_scripts', $payment_methods, 'enqueue_styles' );
        // Set MultiSafepay transaction as shipped
        $this->loader->add_action( 'woocommerce_order_status_' . str_replace( 'wc-', '', get_option( 'multisafepay_trigger_transaction_to_shipped', 'wc-completed' ) ), $payment_methods, 'set_multisafepay_transaction_as_shipped', 10, 1 );
        // Set MultiSafepay transaction as invoiced
        $this->loader->add_action( 'woocommerce_order_status_' . str_replace( 'wc-', '', get_option( 'multisafepay_trigger_transaction_to_invoiced', 'wc-completed' ) ), $payment_methods, 'set_multisafepay_transaction_as_invoiced', 11, 1 );
        // Generate orders from backend.
        if ( is_admin() ) {
            $this->loader->add_action( 'woocommerce_new_order', $payment_methods, 'generate_orders_from_backend', 10, 1 );
        }
        // One notification URL for all payment methods
        $this->loader->add_action( 'woocommerce_api_multisafepay', $payment_methods, 'callback' );
        // One endpoint to handle notifications via POST.
        $this->loader->add_action( 'rest_api_init', $payment_methods, 'multisafepay_register_rest_route' );
        // Ajax related to Apple Pay Direct validation
        $this->loader->add_action( 'wp_ajax_applepay_direct_validation', $payment_methods, 'applepay_direct_validation' );
        $this->loader->add_action( 'wp_ajax_nopriv_applepay_direct_validation', $payment_methods, 'applepay_direct_validation' );
        // Getting total price update for payment methods
        $this->loader->add_action( 'wp_ajax_get_updated_total_price', $payment_methods, 'get_updated_total_price' );
        $this->loader->add_action( 'wp_ajax_nopriv_get_updated_total_price', $payment_methods, 'get_updated_total_price' );
        // Add the MultiSafepay transaction link in the order details page
        $this->loader->add_action( 'woocommerce_admin_order_data_after_payment_info', $payment_methods, 'add_multisafepay_transaction_link' );
    }

    /**
     * Register the hooks related to the MultiSafepay payment component
     *
     * @return void
     */
    public function payment_components_hooks(): void {
        $payment_component_service = new PaymentComponentService();
        // Allow to refresh the data sent to initialize the Payment Components, when in the checkout, something changed in the order details
        $this->loader->add_action( 'wp_ajax_refresh_payment_component_config', $payment_component_service, 'refresh_payment_component_config' );
        $this->loader->add_action( 'wp_ajax_nopriv_refresh_payment_component_config', $payment_component_service, 'refresh_payment_component_config' );
    }

    /**
     * Register the hooks related to the MultiSafepay payment component with QR
     *
     * @return void
     */
    public function payment_components_qr_hooks() {
        $qr_payment_component_service = new QrPaymentComponentService();
        // Set the MultiSafepay QR code transaction
        $this->loader->add_action( 'wp_ajax_set_multisafepay_qr_code_transaction', $qr_payment_component_service, 'set_multisafepay_qr_code_transaction' );
        $this->loader->add_action( 'wp_ajax_nopriv_set_multisafepay_qr_code_transaction', $qr_payment_component_service, 'set_multisafepay_qr_code_transaction' );
        // Get the redirect URL for the order submitted via Payment Components QR
        $this->loader->add_action( 'wp_ajax_get_qr_order_redirect_url', $qr_payment_component_service, 'get_qr_order_redirect_url' );
        $this->loader->add_action( 'wp_ajax_nopriv_get_qr_order_redirect_url', $qr_payment_component_service, 'get_qr_order_redirect_url' );
    }

    /**
     * Register the hooks related to the processing of the MultiSafepay payment component with QR webhooks
     *
     * @return void
     */
    public function callback_hooks() {
        $qr_payment_webhook = new QrPaymentWebhook();
        // Handle the balancer after submit a QR order, to know where to redirect the user
        $this->loader->add_action( 'rest_api_init', $qr_payment_webhook, 'multisafepay_register_rest_route_qr_balancer' );
        // Handle the webhook request from MultiSafepay for the payment status update for QR orders
        $this->loader->add_action( 'rest_api_init', $qr_payment_webhook, 'multisafepay_register_rest_route_qr_notification' );
    }

    /**
     * Register the MultiSafepay payment methods in WooCommerce Blocks.
     *
     * @return void
     */
    public function block_hooks(): void {
        $blocks = new BlocksController();
        // Use the dedicated WooCommerce Blocks lifecycle hook; it is the safe init point after Blocks dependencies are loaded.
        $this->loader->add_action( 'woocommerce_blocks_loaded', $blocks, 'register_multisafepay_payment_methods_blocks' );
        // Map MultiSafepay Payment Component data from WooCommerce Blocks into WC_Order metadata.
        $this->loader->add_action( 'woocommerce_rest_checkout_process_payment_with_context', $blocks, 'map_blocks_payment_data_to_order_meta', 10, 2 );
    }

    /**
     * Register the hooks related to field validation
     *
     * @return void
     */
    public function validation_hooks(): void {
        $validation_service = new ValidationService();
        // Register AJAX action for zip code validation
        $this->loader->add_action( 'wp_ajax_multisafepay_validate_postcode', $validation_service, 'validate_postcode' );
        $this->loader->add_action( 'wp_ajax_nopriv_multisafepay_validate_postcode', $validation_service, 'validate_postcode' );
    }

    /**
     * Run the loader to execute the hooks with WordPress.
     *
     * @return void
     */
    public function init() {
        $this->loader->init();
    }
}

```