Installation & Configuration Guide
Anonymous SecurePay Documentation

Follow this step-by-step guide to install Anonymous SecurePay, activate the WooCommerce payment gateway, configure your wallet and API settings, and complete the recommended WooCommerce integration.
01 — Installation
Install Anonymous SecurePay

Install the plugin directly from your WordPress administration dashboard.
Open Add New Plugins

Click Upload Plugin

Select the Upload Plugin option at the top of the Add Plugins screen.
Select the Plugin File

Click Browse / Choose File and select the Anonymous SecurePay plugin ZIP file stored on your computer.
Install the Plugin

Click Install Now and wait for WordPress to complete the installation.
Activate Anonymous SecurePay

When installation is complete, click Activate Plugin.
Open WooCommerce Payments

From the WordPress Dashboard
WooCommerce Integration
Payment Gateway Enhancement Layer

Use the following WooCommerce enhancement layer to add additional payment tracking, transaction handling, order-status protection and gateway diagnostics.
PHP
Recommended installation location Add this code to the functions.php file of your WordPress child theme. Do not add it directly to header.php.
functions.php
<?php

/**
 * WooCommerce Payment Gateway Enhancement Layer
 *
 * Add to functions.php of your child theme.
 *
 * Features:
 * - Prevent duplicate order completion
 * - Add transaction metadata
 * - Improve payment/order status handling
 * - Add gateway diagnostics to order notes
 * - HPOS-compatible order meta usage
 * - Prevent accidental payment-status manipulation
 * - Add checkout error handling
 * - Improve failed/pending payment handling
 */


/*
=========================================================
 1. PAYMENT GATEWAY INITIALIZATION
=========================================================
*/

add_action('plugins_loaded', function () {

    if (!class_exists('WooCommerce')) {
        return;
    }

    // Make sure WooCommerce payment gateways are available.

    add_filter('woocommerce_payment_gateways', function ($gateways) {

        /*
         * IMPORTANT:
         *
         * Replace these examples with the actual gateway ID
         * used by your payment plugin.
         *
         * Example:
         * $gateway_id = 'my_gateway';
         */

        return $gateways;

    });

}, 20);


/*
=========================================================
 2. PREVENT DUPLICATE PAYMENT PROCESSING
=========================================================
*/

add_action('woocommerce_payment_complete', function ($order_id) {

    $order = wc_get_order($order_id);

    if (!$order) {
        return;
    }

    // Check whether we have already processed this order.

    $already_processed =
        $order->get_meta('_gateway_payment_processed');

    if ($already_processed === 'yes') {
        return;
    }

    // Mark as processed.

    $order->update_meta_data(
        '_gateway_payment_processed',
        'yes'
    );

    $order->update_meta_data(
        '_gateway_payment_processed_at',
        current_time('mysql')
    );

    $order->save();

}, 10);


/*
=========================================================
 3. SAVE PAYMENT TRANSACTION ID
=========================================================
*/

function custom_gateway_save_transaction_id(
    $order_id,
    $transaction_id
) {

    if (empty($order_id) || empty($transaction_id)) {
        return false;
    }

    $order = wc_get_order($order_id);

    if (!$order) {
        return false;
    }

    // Don't overwrite an existing transaction ID.

    $existing = $order->get_transaction_id();

    if (empty($existing)) {

        $order->set_transaction_id(
            sanitize_text_field($transaction_id)
        );

        $order->update_meta_data(
            '_gateway_transaction_id',
            sanitize_text_field($transaction_id)
        );

        $order->save();

        return true;
    }

    return false;
}


/*
=========================================================
 4. ADD TRANSACTION ID TO ADMIN ORDER PAGE
=========================================================
*/

add_action(
    'woocommerce_admin_order_data_after_billing_address',
    function ($order) {

        if (!$order instanceof WC_Order) {
            return;
        }

        $transaction_id = $order->get_transaction_id();

        if (!empty($transaction_id)) {

            echo '<p>';

            echo '<strong>' .
                esc_html__(
                    'Gateway Transaction ID:',
                    'woocommerce'
                ) .
                '</strong><br>';

            echo esc_html($transaction_id);

            echo '</p>';
        }

    }
);


/*
=========================================================
 5. BETTER PAYMENT COMPLETE HANDLING
=========================================================
*/

add_action('woocommerce_payment_complete', function ($order_id) {

    $order = wc_get_order($order_id);

    if (!$order) {
        return;
    }

    // Only process if WooCommerce itself confirms payment.

    if (!$order->is_paid()) {
        return;
    }

    // Prevent duplicate notes.

    $existing_note =
        $order->get_meta('_gateway_success_note');

    if ($existing_note === 'yes') {
        return;
    }

    $order->add_order_note(
        sprintf(
            'Payment successfully confirmed by WooCommerce. Transaction ID: %s',
            $order->get_transaction_id() ?: 'Not supplied'
        )
    );

    $order->update_meta_data(
        '_gateway_success_note',
        'yes'
    );

    $order->save();

}, 20);


/*
=========================================================
 6. HANDLE FAILED PAYMENTS
=========================================================
*/

add_action('woocommerce_order_status_failed', function ($order_id) {

    $order = wc_get_order($order_id);

    if (!$order) {
        return;
    }

    $attempts =
        (int) $order->get_meta('_gateway_payment_attempts');

    $attempts++;

    $order->update_meta_data(
        '_gateway_payment_attempts',
        $attempts
    );

    $order->update_meta_data(
        '_gateway_last_failed_at',
        current_time('mysql')
    );

    $order->save();

});


/*
=========================================================
 7. HANDLE CANCELLED PAYMENTS
=========================================================
*/

add_action(
    'woocommerce_order_status_cancelled',
    function ($order_id) {

        $order = wc_get_order($order_id);

        if (!$order) {
            return;
        }

        $order->update_meta_data(
            '_gateway_cancelled_at',
            current_time('mysql')
        );

        $order->save();

    }
);


/*
=========================================================
 8. PAYMENT ATTEMPT TRACKING
=========================================================
*/

add_action(
    'woocommerce_checkout_order_processed',
    function ($order_id) {

        $order = wc_get_order($order_id);

        if (!$order) {
            return;
        }

        $attempts =
            (int) $order->get_meta('_gateway_payment_attempts');

        $attempts++;

        $order->update_meta_data(
            '_gateway_payment_attempts',
            $attempts
        );

        $order->update_meta_data(
            '_gateway_first_payment_attempt',
            $order->get_meta('_gateway_first_payment_attempt')
                ?: current_time('mysql')
        );

        $order->update_meta_data(
            '_gateway_last_payment_attempt',
            current_time('mysql')
        );

        $order->save();

    }
);


/*
=========================================================
 9. PREVENT PAYMENT STATUS FROM BEING CHANGED
    TO COMPLETED WITHOUT PAYMENT CONFIRMATION
=========================================================
*/

add_filter(
    'woocommerce_order_status_processing_to_completed',
    function ($order_id) {

        $order = wc_get_order($order_id);

        if (!$order) {
            return $order_id;
        }

        if (!$order->is_paid()) {

            $order->add_order_note(
                'Order completion prevented because WooCommerce has no confirmed payment.'
            );

            return false;
        }

        return $order_id;

    }
);


/*
=========================================================
 10. ADD PAYMENT DETAILS TO ORDER EMAILS
=========================================================
*/

add_action(
    'woocommerce_email_order_meta',
    function ($order, $sent_to_admin, $plain_text, $email) {

        if (!$order instanceof WC_Order) {
            return;
        }

        $transaction_id =
            $order->get_transaction_id();

        if (empty($transaction_id)) {
            return;
        }

        if ($plain_text) {

            echo "\n";
            echo "Transaction ID: " . $transaction_id . "\n";

        } else {

            echo '<p>';

            echo '<strong>Transaction ID:</strong> ';
            echo esc_html($transaction_id);

            echo '</p>';
        }

    },
    10,
    4
);


/*
=========================================================
 11. ADD CUSTOMER PAYMENT STATUS TO THANK-YOU PAGE
=========================================================
*/

add_action(
    'woocommerce_thankyou',
    function ($order_id) {

        if (!$order_id) {
            return;
        }

        $order = wc_get_order($order_id);

        if (!$order) {
            return;
        }

        if ($order->is_paid()) {

            echo '<div class="woocommerce-message"
                style="margin-top:20px;">';

            echo '<strong>Payment confirmed.</strong> ';
            echo 'Your payment has been successfully received.';

            echo '</div>';

        } elseif (
            $order->has_status(
                array('pending', 'on-hold')
            )
        ) {

            echo '<div class="woocommerce-info"
                style="margin-top:20px;">';

            echo '<strong>Payment pending.</strong> ';
            echo 'Your payment is currently being verified.';

            echo '</div>';
        }

    },
    20
);


/*
=========================================================
 12. ADD GATEWAY LOGGING FUNCTION
=========================================================
*/

function custom_gateway_log(
    $message,
    $context = array()
) {

    if (!function_exists('wc_get_logger')) {
        return;
    }

    $logger = wc_get_logger();

    $logger->info(
        $message,
        array(
            'source'  => 'custom-payment-gateway',
            'context' => $context,
        )
    );

}


/*
=========================================================
 13. SAFE API RESPONSE VALIDATION
=========================================================
*/

function custom_gateway_is_successful_response(
    $response
) {

    if (empty($response)) {
        return false;
    }

    if (is_wp_error($response)) {
        return false;
    }

    if (is_string($response)) {

        $decoded = json_decode($response, true);

        if (json_last_error() === JSON_ERROR_NONE) {
            $response = $decoded;
        }
    }

    if (!is_array($response)) {
        return false;
    }

    /*
     * Accept common success formats.
     *
     * Adjust these according to your gateway's actual API.
     */

    $success_values = array(
        'success',
        'successful',
        'paid',
        'completed',
        'approved',
        'confirmed'
    );

    foreach ($success_values as $key) {

        if (
            isset($response[$key]) &&
            (
                $response[$key] === true ||
                $response[$key] === 1 ||
                $response[$key] === '1' ||
                strtolower((string) $response[$key]) === 'true'
            )
        ) {
            return true;
        }
    }

    if (
        isset($response['status']) &&
        in_array(
            strtolower((string) $response['status']),
            $success_values,
            true
        )
    ) {
        return true;
    }

    return false;
}


/*
=========================================================
 14. SANITIZE TRANSACTION REFERENCE
=========================================================
*/

function custom_gateway_clean_reference(
    $reference
) {

    if (empty($reference)) {
        return '';
    }

    $reference = wp_strip_all_tags($reference);

    $reference = sanitize_text_field($reference);

    return substr($reference, 0, 191);
}


/*
=========================================================
 15. PREVENT DUPLICATE TRANSACTION REFERENCES
=========================================================
*/

function custom_gateway_transaction_exists(
    $transaction_id
) {

    if (empty($transaction_id)) {
        return false;
    }

    global $wpdb;

    $transaction_id =
        custom_gateway_clean_reference($transaction_id);

    $result = $wpdb->get_var(
        $wpdb->prepare(
            "
            SELECT post_id
            FROM {$wpdb->postmeta}
            WHERE meta_key = '_transaction_id'
            AND meta_value = %s
            LIMIT 1
            ",
            $transaction_id
        )
    );

    return !empty($result);
}


/*
=========================================================
 16. ADD GATEWAY INFORMATION TO ORDER NOTES
=========================================================
*/

function custom_gateway_add_note(
    $order_id,
    $message
) {

    $order = wc_get_order($order_id);

    if (!$order) {
        return false;
    }

    $order->add_order_note(
        sanitize_textarea_field($message)
    );

    return true;
}


/*
=========================================================
 17. CLEAN OLD TEMPORARY PAYMENT DATA
=========================================================
*/

add_action(
    'woocommerce_cleanup_sessions',
    function () {

        global $wpdb;

        /*
         * This intentionally does NOT delete WooCommerce orders.
         *
         * Only remove temporary gateway data if you have explicitly
         * created such data.
         */

        $wpdb->query(
            "
            DELETE FROM {$wpdb->options}
            WHERE option_name LIKE '_transient_custom_gateway_%'
            OR option_name LIKE '_site_transient_custom_gateway_%'
            "
        );

    }
);


/*
=========================================================
 18. DISABLE CACHE FOR PAYMENT CALLBACKS
=========================================================
*/

add_action('init', function () {

    if (
        isset($_GET['wc-api']) ||
        isset($_GET['payment_callback']) ||
        isset($_GET['webhook'])
    ) {

        if (!headers_sent()) {

            nocache_headers();

            header(
                'Cache-Control: no-store, no-cache, must-revalidate, max-age=0'
            );

            header(
                'Pragma: no-cache'
            );
        }
    }

});


/*
=========================================================
 19. SECURITY: PREVENT DIRECT EXECUTION
=========================================================
*/

if (!defined('ABSPATH')) {
    exit;
}

?>
Language: PHP WooCommerce Integration Layer
Important

Always create a backup before modifying theme files. The gateway ID and API response structure should be adjusted to match the actual payment gateway implementation. Test the integration before using it on a production website.