WooCommerce: Auto complete paid orders

5 comments

1. The most accurate, effective and lightweight solution (For WooCommerce 3 and above) – 2019

   This filter hook is located in:

   • WC_Order Class inside payment_complete() method which is used by all payment methods when a payment is required in checkout.
   • WC_Order_Data_Store_CPT Class inside update() method.

   As you can see, by default the allowed paid order statuses are “processing” and “completed”.

   ###Explanations:

   1. Lightweight and effective:

   As it is a filter hook, woocommerce_payment_complete_order_status is only triggered when an online payment is required (not for “cheque”, “bacs” or “cod” payment methods). Here we just change the allowed paid order statuses.

   So no need to add conditions for the payment gateways or anything else.

   2. Accurate (avoid multiple notifications):

   This is the only way to avoid sending 2 different customer notifications at the same time:
   • One for “processing” orders status
   • And one for “completed” orders status.

   So customer is only notified once on “completed” order status.

   Using the code below, will just change the paid order status (that is set by the payment gateway for paid orders) to “completed”:

   add_action( 'woocommerce_payment_complete_order_status', 'wc_auto_complete_paid_order', 10, 3 );
   function wc_auto_complete_paid_order( $status, $order_id, $order ) {
       return 'completed';
   }
   

   Code goes in function.php file of the active child theme (or active theme).

   Related: WooCommerce: autocomplete paid orders based on shipping method

   ---

   2018 – Improved version (For WooCommerce 3 and above)

   Based on Woocommerce official hook, I found a solution to this problem *(Works with WC 3+).

   In Woocommerce for all other payment gateways others than bacs (Bank Wire), cheque and cod (Cash on delivery), the paid order statuses are “processing” and “completed”.

   So I target “processing” order status for all payment gateways like Paypal or credit card payment, updating the order status to complete.

   The code:

   add_action( 'woocommerce_thankyou', 'wc_auto_complete_paid_order', 20, 1 );
   function wc_auto_complete_paid_order( $order_id ) {
       if ( ! $order_id )
           return;
       
       // Get an instance of the WC_Product object
       $order = wc_get_order( $order_id );
       
       // No updated status for orders delivered with Bank wire, Cash on delivery and Cheque payment methods.
       if ( in_array( $order->get_payment_method(), array( 'bacs', 'cod', 'cheque', '' ) ) ) {
           return;
       } 
       // For paid Orders with all others payment methods (paid order status "processing")
       elseif( $order->has_status('processing') ) {
           $order->update_status( 'completed' );
       }
   }
   

   Code goes in function.php file of the active child theme (or active theme).

   ---

   Original answer (For all woocommerce versions):

   The code:

   /**
    * AUTO COMPLETE PAID ORDERS IN WOOCOMMERCE
    */
   add_action( 'woocommerce_thankyou', 'custom_woocommerce_auto_complete_paid_order', 10, 1 );
   function custom_woocommerce_auto_complete_paid_order( $order_id ) {
       if ( ! $order_id )
       return;
   
       $order = wc_get_order( $order_id );
   
       // No updated status for orders delivered with Bank wire, Cash on delivery and Cheque payment methods.
       if ( ( 'bacs' == get_post_meta($order_id, '_payment_method', true) ) || ( 'cod' == get_post_meta($order_id, '_payment_method', true) ) || ( 'cheque' == get_post_meta($order_id, '_payment_method', true) ) ) {
           return;
       } 
       // For paid Orders with all others payment methods (with paid status "processing")
       elseif( $order->get_status()  === 'processing' ) {
           $order->update_status( 'completed' );
       }
   }
   

   Code goes in function.php file of the active child theme (or active theme).

   With the help of this post: How to check payment method on a WooCommerce order by id?

   with this : get_post_meta( $order_id, '_payment_method', true ); from helgatheviking

   “Bank wire” (bacs), “Cash on delivery” (cod) and “Cheque” (cheque) payment methods are ignored and keep their original order status.

   Updated the code for compatibility with WC 3.0+ (2017-06-10)

2. For me this hook was called even if the payment did not go through or failed, and this resulted to completed failed payments. After some research I changed it to use ‘woocommerce_payment_complete’ because it’s called only when payment is complete and it covers the issue that @LoicTheAztec mentions above –

   add_action( 'woocommerce_payment_complete', 'wc_auto_complete_paid_order', 20, 1 );
   function wc_auto_complete_paid_order( $order_id ) {
       if ( ! $order_id )
           return;
   
       // Get an instance of the WC_Product object
       $order = wc_get_order( $order_id );
   
       // No updated status for orders delivered with Bank wire, Cash on delivery and Cheque payment methods.
       if ( in_array( $order->get_payment_method(), array( 'bacs', 'cod', 'cheque', '' ) ) ) {
           return;
       // Updated status to "completed" for paid Orders with all others payment methods
       } else {
           $order->update_status( 'completed' );
       }
   }
   

3. For me, the simplest hook to modify order status when payment is completed is ‘woocommerce_order_item_needs_processing’ as this filter hook is meant to modify the target order status when payment completes.

   This is what the final snippet will look alike:

   add_filter('woocommerce_order_item_needs_processing', '__return_false',999);
   

   It also compatible with the other plugins on sites.

4. For me, on a testing system with PayPal Sandbox (WooCommerce PayPal Payments plugin) the LoicTheAztec solution (2019 update) worked only when I added the $order->update_status( 'completed' ); code line. The return 'completed'; has not an effect in my case, I left it just because it’s a filter.

   add_filter( 'woocommerce_payment_complete_order_status', function( $status, $order_id, $order ) {
       $order->update_status( 'completed' );
       return 'completed';
   }, 10, 3 );
   

5. If you are looking for autocompletion of virtual orders (like courses, ebooks, downloadables etc), this might be useful.

    * Auto Complete all WooCommerce virtual orders.
    * 
    * @param  int  $order_id The order ID to check
    * @return void
    */
   function custom_woocommerce_auto_complete_virtual_orders( $order_id ) {
   
       // if there is no order id, exit
       if ( ! $order_id ) {
           return;
       }
   
       // No updated status for orders delivered with Bank wire, Cash on delivery and Cheque payment methods.
       if ( in_array( $order->get_payment_method(), array( 'bacs', 'cod', 'cheque', '' ) ) ) {
           return;
       } 
   
       // get the order and its exit
       $order = wc_get_order( $order_id );
       $items = $order->get_items();
   
       // if there are no items, exit
       if ( 0 >= count( $items ) ) {
           return;
       }
   
       // go through each item
       foreach ( $items as $item ) {
   
           // if it is a variation
           if ( '0' != $item['variation_id'] ) {
   
               // make a product based upon variation
               $product = new WC_Product( $item['variation_id'] );
   
           } else {
   
               // else make a product off of the product id
               $product = new WC_Product( $item['product_id'] );
   
           }
   
           // if the product isn't virtual, exit
           if ( ! $product->is_virtual() ) {
               return;
           }
       }
   
       /*
        * If we made it this far, then all of our items are virual
        * We set the order to completed.
        */
       $order->update_status( 'completed' );
   }
   add_action( 'woocommerce_thankyou', 'custom_woocommerce_auto_complete_virtual_orders' );
   

   Adapted from https://gist.github.com/jessepearson/33f383bb3ea33069822817cfb1da4258

Comments are closed.