Woocommerce实现X天后自动取消On-Hold状态订单需求问询

我之前在为巴西地区的电商网站开发支付方案时，找了一圈都没找到适配银行汇票（bank billet）需求的现成支付网关，索性自己开发了一个自定义的「bacs」类型网关。这种支付方式的特点是用户完成结账后会收到有效期大概7天的银行汇票，属于线下支付范畴，所以订单会自动进入「on-hold」状态。但问题来了——这些逾期未支付的订单不能一直挂着，我需要实现一个功能：让这类特定的「on-hold」订单在X天后自动取消。

下面是我最终落地的解决方案，以WooCommerce环境为例：

核心逻辑 #

借助定时任务定期扫描系统中状态为「on-hold」、支付方式为自定义「bacs」的订单，对比订单创建时间和当前时间，若间隔超过设定的X天，就自动将订单状态改为「cancelled」并添加操作备注。

代码实现 #

你可以将以下代码添加到主题的functions.php文件，或者封装成独立插件：

// 初始化定时任务
add_action('wp', 'setup_custom_bacs_cancellation_cron');
function setup_custom_bacs_cancellation_cron() {
    // 检查定时任务是否已存在，避免重复创建
    if (!wp_next_scheduled('custom_bacs_order_cancellation')) {
        // 这里设置为每天执行一次，可根据需求调整（比如twicedaily、hourly）
        wp_schedule_event(time(), 'daily', 'custom_bacs_order_cancellation');
    }
}

// 定时任务执行的核心处理函数
add_action('custom_bacs_order_cancellation', 'cancel_expired_bacs_orders');
function cancel_expired_bacs_orders() {
    // 设定逾期天数X，这里以银行汇票的7天有效期为例
    $expiry_days = 7;
    // 计算逾期时间节点
    $cutoff_time = strtotime("-$expiry_days days");

    // 查询符合条件的订单
    $order_query = array(
        'status' => 'on-hold',
        'payment_method' => 'bacs', // 务必和你的自定义网关标识一致
        'date_created' => '<=' . date('Y-m-d H:i:s', $cutoff_time),
        'limit' => -1, // 拉取所有符合条件的订单
    );
    $orders = wc_get_orders($order_query);

    // 遍历处理每个订单
    foreach ($orders as $order) {
        // 更新订单状态并添加备注
        $order->update_status(
            'cancelled',
            '订单因逾期未支付（银行汇票有效期已过），系统自动取消'
        );
    }
}

// 如需移除定时任务，可启用以下代码（调试或停用功能时用）
// add_action('wp', 'remove_custom_bacs_cancellation_cron');
// function remove_custom_bacs_cancellation_cron() {
//     wp_clear_scheduled_hook('custom_bacs_order_cancellation');
// }

关键注意事项 #

• 支付方式标识匹配：确保你的自定义「bacs」网关在创建订单时，正确设置了支付方式的slug为bacs，否则查询会找不到目标订单。
• 定时任务频率调整：如果需要更频繁地检查订单，可以修改wp_schedule_event的第二个参数，比如改成hourly（每小时执行），或者添加自定义Cron间隔。
• WP Cron兼容性：如果你的网站禁用了默认的WP Cron，需要在服务器上配置系统级Cron Job，定期访问wp-cron.php来触发任务。
• 测试验证：上线前可以手动触发定时任务（比如直接访问your-site.com/wp-cron.php），或者使用Cron测试插件验证逻辑是否正常执行。

内容的提问来源于stack exchange，提问作者Daniel Romagnoli