当前位置：首页 > 文章列表 > 文章 > php教程 > WooCommerce自动取消失败订单教程

WooCommerce自动取消失败订单教程

2025-07-11 08:09:24 0浏览收藏

今天golang学习网给大家带来了《自动取消WooCommerce失败订单教程》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

自动取消 WooCommerce 失败订单：一步步教程

本教程旨在帮助您解决 WooCommerce 中自动将“失败”状态的订单更改为“已取消”状态的问题。我们将探讨如何使用 woocommerce_cancel_unpaid_orders 钩子，并提供可直接使用的代码示例，确保您的 WooCommerce 商店能够自动处理未支付订单，提高运营效率。

在 WooCommerce 商店中，自动处理未支付订单至关重要。如果客户在一定时间内未能成功支付订单，将其状态自动更改为“已取消”可以释放库存，避免不必要的资源占用。本教程将指导您如何实现这一功能，重点介绍正确的 WordPress 钩子以及完整的代码示例。

使用 woocommerce_cancel_unpaid_orders 钩子

原始代码尝试使用 woocommerce_cancel_unpaid_submitted 钩子，但该钩子并不存在。正确的钩子是 woocommerce_cancel_unpaid_orders。此钩子专门用于处理未支付订单的自动取消。

代码实现

以下是修改后的代码，它使用 woocommerce_cancel_unpaid_orders 钩子，并将“失败”状态的订单自动更改为“已取消”状态：

<?php
add_action( 'woocommerce_cancel_unpaid_orders', 'cancel_failed_orders' );

function cancel_failed_orders() {
    $days_delay = 1;
    $one_day    = 24 * 60 * 60;
    $today      = strtotime( date('Y-m-d') );

    $failed_orders = wc_get_orders( array(
        'limit'        => -1,
        'status'       => 'failed', // 注意：这里应使用 'failed'，而不是 'wc-failed'
        'date_created' => '<' . ( $today - ($days_delay * $one_day) ),
    ) );

    if ( ! empty( $failed_orders ) ) {
        $cancelled_text = __("No successful payment", "woocommerce");
        foreach ( $failed_orders as $order ) {
            $order->update_status( 'cancelled', $cancelled_text ); // 注意：这里应使用 'cancelled'，而不是 'wc-cancelled'
        }
    }
}

代码解释：

add_action( 'woocommerce_cancel_unpaid_orders', 'cancel_failed_orders' );: 将 cancel_failed_orders 函数绑定到 woocommerce_cancel_unpaid_orders 钩子上。
$days_delay = 1;: 设置延迟天数，即订单创建多久后会被取消。这里设置为 1 天。
$one_day = 24 * 60 * 60;: 计算一天有多少秒。
$today = strtotime( date('Y-m-d') );: 获取今天的 Unix 时间戳。
wc_get_orders(...): 使用 wc_get_orders 函数获取所有状态为“失败”，且创建日期早于 $days_delay 天前的订单。
- 'status' => 'failed': 查询状态为“失败”的订单。重要提示：这里直接使用 failed，而不是 wc-failed。wc-failed 是订单状态的内部表示，而 failed 是更常用的状态名称。
- *`'date_created' => '<' . ( $today - ($days_delay $one_day) )`**: 查询创建日期早于指定日期的订单。
if ( ! empty( $failed_orders ) ) { ... }: 检查是否找到了需要取消的订单。
$cancelled_text = __("No successful payment", "woocommerce");: 设置取消订单的原因。
$order->update_status( 'cancelled', $cancelled_text );: 循环遍历所有找到的订单，并将它们的状态更新为“已取消”，并添加取消原因。重要提示： 这里直接使用 cancelled，而不是 wc-cancelled。wc-cancelled 是订单状态的内部表示，而 cancelled 是更常用的状态名称。

部署方法

将上述代码保存为一个 PHP 文件（例如 cancel-failed-orders.php），然后将其上传到 WordPress 插件目录（wp-content/plugins/）或创建一个 mu-plugin 目录（wp-content/mu-plugins/），并将文件放入其中。 mu-plugins 无需激活，会自动加载。

注意事项

订单状态： 确保使用正确的订单状态名称 (failed 和 cancelled)。
时间戳计算： 检查时间戳计算是否正确，以确保订单在正确的时间被取消。
测试： 在生产环境中使用之前，请务必在测试环境中进行充分测试。
兼容性： 确保代码与您的 WooCommerce 版本兼容。

总结

通过使用正确的 woocommerce_cancel_unpaid_orders 钩子，并结合 wc_get_orders 函数和订单状态更新，您可以轻松实现 WooCommerce 中自动取消“失败”订单的功能。记住，在部署到生产环境之前，务必进行充分的测试。通过自动处理未支付订单，您可以提高商店的运营效率，并确保库存的准确性。

终于介绍完啦！小伙伴们，这篇关于《WooCommerce自动取消失败订单教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！