WooCommerce实现基于自定义支付状态的订单支付权限控制

实现逻辑 #

• 绕过WooCommerce原生仅靠订单状态判断支付权限的逻辑，直接读取Admin Customer Order Fields插件生成的自定义支付状态字段值作为核心判断标准
• 匹配规则：自定义支付状态为APMOKĖTA（已支付）时强制关闭支付入口；状态为ATIDĖTAS MOKĖJIMAS（延期支付）时强制开放支付入口，不受原生订单状态限制，completed状态下的延期支付订单也可正常发起支付
• 保留原有钩子的兼容逻辑，不破坏Partial Payments等现有插件的正常运行

延期支付场景订单参考截图

完整实现代码 #

// 注意：请将代码中 YOUR_CUSTOM_PAYMENT_STATUS_META_KEY 替换为自定义支付状态字段对应的实际meta键
add_filter( 'woocommerce_valid_order_statuses_for_payment', 'custom_pay_status_allowed_pay_statuses', 999, 2 );
function custom_pay_status_allowed_pay_statuses( $statuses, $order ) {
    if ( ! $order instanceof WC_Order ) {
        return $statuses;
    }

    $custom_pay_status = $order->get_meta( 'YOUR_CUSTOM_PAYMENT_STATUS_META_KEY', true );
    // 延期支付场景下，将processing、completed状态加入允许支付的状态列表
    if ( $custom_pay_status === 'ATIDĖTAS MOKĖJIMAS' ) {
        $statuses[] = 'processing';
        $statuses[] = 'completed';
    }

    return array_unique( $statuses );
}

// 最高优先级覆写订单支付权限核心判断
add_filter( 'woocommerce_order_needs_payment', 'custom_pay_status_check_needs_pay', 999, 3 );
function custom_pay_status_check_needs_pay( $needs_payment, $order, $valid_statuses ) {
    if ( ! $order instanceof WC_Order ) {
        return $needs_payment;
    }

    $custom_pay_status = $order->get_meta( 'YOUR_CUSTOM_PAYMENT_STATUS_META_KEY', true );
    // 已支付状态直接关闭支付入口
    if ( $custom_pay_status === 'APMOKĖTA' ) {
        return false;
    }
    // 延期支付状态直接开放支付入口
    if ( $custom_pay_status === 'ATIDĖTAS MOKĖJIMAS' ) {
        return true;
    }

    return $needs_payment;
}

部署注意事项 #

• 代码存放位置：将代码添加到子主题的functions.php文件，或者自定义功能插件中，不要直接修改父主题、WooCommerce核心文件或第三方插件文件，避免版本更新时代码被覆盖
• 自定义字段键确认：如果不清楚支付状态字段的meta键，可进入任意订单编辑页，找到页面下方的自定义字段面板，查找对应「支付状态」字段的键名，替换代码中的YOUR_CUSTOM_PAYMENT_STATUS_META_KEY占位符即可
• 优先级说明：代码设置了999的最高执行优先级，不会和现有Partial Payments、Admin Customer Order Fields插件的逻辑产生冲突
• 上线前验证：可分别创建标记为APMOKĖTA、ATIDĖTAS MOKĖJIMAS的测试订单，访问订单查看支付链接、跳转支付页验证权限控制是否符合预期

内容的提问来源于stack exchange，提问作者Tomas Boravskis