Fix: exclude POS cash orders from vendor withdrawable balance

includes/Order/Hooks.php

@@ -123,7 +123,29 @@ public function on_order_status_change( $order_id, $old_status, $new_status, $or
          */
         $exclude_cod_payment = 'on' === dokan_get_option( 'exclude_cod_payment', 'dokan_withdraw', 'off' );
 
-        if ( $exclude_cod_payment && 'cod' === $order->get_payment_method() ) {
+        $should_exclude_cod_payment = $exclude_cod_payment && 'cod' === $order->get_payment_method();
+
+        /**
+         * Filter whether the order should be excluded from vendor withdrawal balance.
+         *
+         * @since DOKAN_SINCE
+         *
+         * @param bool     $should_exclude_cod_payment Whether to exclude COD payment from balance.
+         * @param WC_Order $order                      Order object.
+         * @param int      $order_id                   Order ID.
+         * @param string   $new_status                 New order status.
+         * @param bool     $exclude_cod_payment        Whether exclude COD option is enabled.
+         */
+        $should_exclude_cod_payment = apply_filters(
+            'dokan_order_should_exclude_from_vendor_balance',
+            $should_exclude_cod_payment,
+            $order,
+            $order_id,
+            $new_status,
+            $exclude_cod_payment
+        );
+
+        if ( $should_exclude_cod_payment ) {
             return;
         }
 

includes/Order/RefundHandler.php

@@ -19,7 +19,7 @@
         add_filter( 'dokan_refund_should_insert_into_vendor_balance', [ $this, 'exclude_cod_payment' ], 10, 3 );
         add_filter( 'dokan_vendor_earning_in_refund', [ $this, 'get_vendor_earning_in_refund' ], 10, 2 );
         add_action( 'dokan_refund_adjust_vendor_balance', [ $this, 'insert_into_balance_table' ], 10, 3 );
 //        add_action( 'dokan_refund_adjust_dokan_orders', [ $this, 'update_order_amounts' ], 10, 3 );
         add_action( 'dokan_refund_after_dokan_orders_updated', [ $this, 'clear_order_caches' ], 10, 3 );
     }
 
@@ -87,25 +87,41 @@
      * @param bool $ret
      * @param \WC_Order_Refund $refund_order
      * @param \WC_Order $order
-     * @return bool
+     * @return bool 
      */
     public function exclude_cod_payment( $ret, $refund_order, $order ) {
         // return if $order is not an instance of WC_Order
         if ( ! $order ) {
             return $ret;
         }
 
-        // if cod is not payment method return
-        if ( 'cod' !== $order->get_payment_method() ) {
-            return $ret;
-        }
+        $order_id   = $order->get_id();
+        $new_status = $order->get_status();
+        /**
+         * Get the base setting from Dokan options
+         */
+        $exclude_cod_option = 'on' === dokan_get_option( 'exclude_cod_payment', 'dokan_withdraw', 'off' );
 
         /**
-         * If `exclude_cod_payment` is enabled, don't include the fund in vendor's refund balance.
+         * Calculate the default logic (Is it COD and is the option ON?)
          */
-        $exclude_cod_payment = 'on' === dokan_get_option( 'exclude_cod_payment', 'dokan_withdraw', 'off' );
+        $should_exclude_cod_payment = $exclude_cod_option && 'cod' === $order->get_payment_method();
+
+        /**
+         * Apply the filter so other plugins (like wePOS) can override this.
+         * Use the exact same filter name for consistency across the whole system.
+         */
+        $should_exclude_cod_payment = apply_filters(
+            'dokan_order_refund_should_exclude_from_vendor_balance',
+            $should_exclude_cod_payment,
+            $order,
+            $order_id,
+            $new_status,
+            $exclude_cod_option,
+            $refund_order,
+        );
 
-        if ( $exclude_cod_payment ) {
+        if ( $should_exclude_cod_payment ) {
             return false;
         }