Hướng dẫn kích hoạt giảm ma sát lên đơn nạp xu trong theme Init Manga (Auto Order Flow)

Flow này cho phép rút gọn hành trình từ chọn gói nạp đến thanh toán chỉ trong một bước, loại bỏ hoàn toàn giỏ hàng và trang checkout mặc định của WooCommerce.

Tổng quan cơ chế trong Init Manga

Hàm init_manga_rest_buy_coin trong theme điều khiển toàn bộ logic nạp xu, với 2 nhánh rõ ràng:

• Checkout Flow (mặc định): Thêm sản phẩm vào giỏ → chuyển đến trang thanh toán
• Auto Order Flow: Tạo đơn hàng trực tiếp → gọi gateway → redirect thanh toán

Việc chuyển đổi giữa 2 flow này được kiểm soát thông qua filter nội bộ của theme.

Kích hoạt Auto Order Flow

Để bật cơ chế giảm ma sát, bạn chỉ cần thêm filter sau:

add_filter('init_manga_topup_auto_create_order', '__return_true');

Khi được kích hoạt, Init Manga sẽ:

• Bỏ qua hoàn toàn bước giỏ hàng và checkout
• Tạo đơn hàng bằng wc_create_order()
• Gọi trực tiếp process_payment() từ gateway
• Trả về URL redirect để frontend điều hướng ngay

Ưu tiên gateway theo ý đồ vận hành

Init Manga sử dụng hàm init_manga_pick_payment_gateway() để chọn gateway. Bạn có thể can thiệp vào danh sách này để ưu tiên gateway mong muốn:

add_filter('init_manga_topup_gateway_candidates', function($gateways) {

    // Ưu tiên gateway sepay
    if (isset($gateways['sepay'])) {
        return ['sepay' => $gateways['sepay']] + $gateways;
    }

    return $gateways;

});

Logic này đảm bảo gateway sepay luôn được chọn đầu tiên trong danh sách khả dụng.

Chi tiết kỹ thuật đáng chú ý

• Rate limit: Giới hạn 5 giây giữa các lần tạo đơn bằng user meta _init_last_topup_time
• Session handling: Tự động khởi tạo WC()->cart và WC()->customer nếu chưa tồn tại
• Chỉ hỗ trợ virtual product: Tránh phát sinh logic vận chuyển
• Đánh dấu đơn nạp: Sử dụng meta _is_init_manga_topup để phục vụ xử lý hậu kỳ
• Fallback an toàn: Nếu gateway lỗi, đơn sẽ bị chuyển sang trạng thái failed

Khi nào nên áp dụng?

• Khi hệ thống chỉ phục vụ nạp xu / sản phẩm số
• Khi không cần thu thập thêm thông tin billing
• Khi muốn tối đa hóa tỷ lệ hoàn tất thanh toán

Kết luận

Auto Order Flow trong Init Manga không chỉ là một tuỳ chọn kỹ thuật, mà là một đòn bẩy chuyển đổi. Khi loại bỏ các bước trung gian không cần thiết, bạn đang trực tiếp rút ngắn đường đi từ ý định đến hành động — và đó chính là nơi doanh thu được tạo ra.