How to Create Custom Payment Gateways in WooCommerce – 2026

/*
 * Snippet: How to Create Custom Payment Gateways in WooCommerce – 2026
 * Author: John Cook 
 * URL: https://wcsuccessacademy.com/?p=1143
 * Tested with WooCommerce 10.7.0
 * "Define a custom payment gateway class"
*/
function wcsuccess_init_custom_gateway_class() {
    class WC_Gateway_WCSuccess extends WC_Payment_Gateway {
        public function __construct() {
            $this->id = 'wcsuccess';
            $this->icon = apply_filters('woocommerce_wcsuccess_icon', '');
            $this->has_fields = false;
            $this->method_title = 'WCSuccess Gateway';
            $this->method_description = 'Custom Payment Gateway for WCSuccess.';

            // Load the settings.
            $this->init_form_fields();
            $this->init_settings();

            // Define user set variables
            $this->title = $this->get_option('title');
            $this->description = $this->get_option('description');

            // Actions
            add_action('woocommerce_update_options_payment_gateways_' . $this->id, array($this, 'process_admin_options'));
        }

        public function init_form_fields() {
            $this->form_fields = array(
                'title' => array(
                    'title'       => 'Title',
                    'type'        => 'text',
                    'description' => 'This controls the title which the user sees during checkout.',
                    'default'     => 'WCSuccess Payment',
                    'desc_tip'    => true,
                ),
                'description' => array(
                    'title'       => 'Description',
                    'type'        => 'textarea',
                    'description' => 'This controls the description which the user sees during checkout.',
                    'default'     => 'Pay with your credit card via our super-cool payment gateway.',
                ),
            );
        }

        public function process_payment( $order_id ) {
            $order = wc_get_order( $order_id );

            // Mark as on-hold (we're awaiting the payment)
            $order->update_status('on-hold', 'Awaiting offline payment');

            // Reduce stock levels
            $order->reduce_order_stock();

            // Remove cart
            WC()->cart->empty_cart();

            // Return thankyou redirect
            return array(
                'result'   => 'success',
                'redirect' => $this->get_return_url( $order )
            );
        }
    }
}

add_action('plugins_loaded', 'wcsuccess_init_custom_gateway_class');

/*
 * Snippet: How to Create Custom Payment Gateways in WooCommerce – 2026
 * Author: John Cook 
 * URL: https://wcsuccessacademy.com/?p=1143
 * Tested with WooCommerce 10.7.0
 * "Register the custom payment gateway"
*/
function wcsuccess_add_custom_gateway_class( $methods ) {
    $methods[] = 'WC_Gateway_WCSuccess'; 
    return $methods;
}
add_filter('woocommerce_payment_gateways', 'wcsuccess_add_custom_gateway_class');