Tích hợp ZaloPay vào WooCommerce — kết hợp với Zalo OA cho marketing

ZaloPay là ví điện tử của VNG với 15 triệu user — sức mạnh thật sự đến từ khả năng kết nối Zalo OA để chạy marketing retention. Tỉ lệ mở tin nhắn Zalo OA cao gấp 5-10 lần email, conversion từ follower OA cao hơn paid traffic 30-50%.

Tích hợp ZaloPay vào WooCommerce qua plugin community mất 1-2 ngày. Bài này hướng dẫn end-to-end + link Zalo OA + 5 lỗi phổ biến.

Vì sao ZaloPay khác biệt ở khả năng marketing Zalo OA

ZaloPay đứng thứ 3 thị phần ví điện tử VN sau MoMo và ShopeePay, nhưng lợi thế độc quyền là hệ sinh thái Zalo với hơn 90 triệu user. Shop tích hợp ZaloPay có thể push notification qua Zalo OA miễn phí 4.000 message/tháng.

Đó là lý do nên cân nhắc ZaloPay khác hẳn các cổng thanh toán còn lại — không chỉ để collect payment, mà để build retention channel dài hạn. Shop đã có Zalo OA active nên đặt ZaloPay làm tier 2 sau MoMo/VNPAY.

3 tier phí và yêu cầu volume

<td(đáng kể)

3 use case ZaloPay xứng đáng làm gateway chính

• Shop đã có Zalo OA hơn 5.000 follower: leverage được kênh push miễn phí — gửi promo, reminder cart abandonment, upsell sau order.
• Target khách 25-40 tuổi VN: demographic ZaloPay overlap mạnh với phân khúc này, conversion qua ZaloPay cao hơn 8-15% so với ATM.
• Bán sản phẩm cần retention dài: mỹ phẩm, supplement, đồ ăn — khách quay lại đều, marketing qua Zalo OA hiệu quả cao.

Bước 1 — Đăng ký ZaloPay Merchant qua portal

Truy cập merchant.zalopay.vn click “Đăng ký mới”. Process 3-5 ngày làm việc, yêu cầu giấy phép kinh doanh + link Zalo OA chính thức của shop.

4 thông tin trả về sau approve

ZaloPay gửi email approval với 4 credential phải lưu password manager. Cơ chế 2 key độc lập (Key 1 sign + Key 2 verify) giúp tách trách nhiệm — leak 1 key chưa break toàn bộ.

1. App ID: mã định danh app shop, vd 2553 — public, paste vào plugin setting.
2. Key 1: dùng sign request HMAC SHA256 khi shop gọi API ZaloPay tạo order.
3. Key 2: dùng verify chữ ký callback từ ZaloPay về shop — đảm bảo callback không bị giả mạo.
4. MAC Algorithm: mặc định HMACSHA256, không cần đổi trừ khi ZaloPay yêu cầu rõ.

Link Zalo OA với account ZaloPay Merchant

Trong dashboard merchant tab “Liên kết OA”, paste OA ID của shop để link. Sau khi link, ZaloPay tự push notification thanh toán thành công vào Zalo OA cho khách đã follow.

• OA chưa verified: register OA chính thức tại oa.zalo.me trước — cần giấy phép kinh doanh khớp với merchant ZaloPay.
• OA chưa có follower: chạy chiến dịch acquire follower trước khi tích hợp — minimum 1.000 follower để ROI marketing đáng.
• Template notification: design template tin nhắn confirm payment trong dashboard OA — branded với logo shop.

Bước 2 — Cài plugin ZaloPay community từ GitHub

ZaloPay chưa có plugin official WordPress.org (giống MoMo). Dùng plugin community phổ biến nhất là Mona Software hoặc repo official ZaloPay trên GitHub.

Tải plugin từ repo official ZaloPay

1. Truy cập github.com/zalopay/sample-code — repo official có sample WooCommerce.
2. Click “Code” → “Download ZIP” để tải file woo-zalopay.zip.
3. Vào WordPress admin Plugins → Add New → Upload Plugin, chọn file zip.
4. Click Install Now rồi Activate.
5. Vào WooCommerce → Settings → Payments tìm “ZaloPay” và click Manage.

Cấu hình App ID + 2 key + callback URL

Trang config có 9 field. Đặc biệt lưu ý 2 URL callback và redirect — sai 1 trong 2 là khách paid nhưng order không update.

# WooCommerce → Settings → Payments → ZaloPay → Manage

Enable: ✓ tick
Title: "Thanh toán qua ví ZaloPay"
Description: "Quét QR ZaloPay hoặc mở app thanh toán nhanh."

App ID: 2553
Key 1: PcY4iZIKFCIdgZvA6ueMcMHHUbRLYjPL
Key 2: kLtgPl8HHhfvMuDHPwKfgfsY4Ydm9eIM

MAC Algorithm: HMACSHA256

Endpoint Sandbox: https://sb-openapi.zalopay.vn/v2/create
Endpoint Production: https://openapi.zalopay.vn/v2/create

Callback URL: https://yourdomain.vn/wc-api/zalopay_callback/
Redirect URL: https://yourdomain.vn/wc-api/zalopay_redirect/

Mode: Sandbox (đổi Production sau test pass)

Bước 3 — Test sandbox với app ZaloPay Test riêng

Giống MoMo, ZaloPay có app sandbox tách biệt khỏi app production. Cài app “ZaloPay Test” từ APK link trong dashboard merchant — không thể test bằng app ZaloPay trên store.

Test flow QR code + redirect

Tạo sản phẩm test giá 100.000đ, add cart, checkout chọn ZaloPay. WooCommerce gọi API ZaloPay trả về QR + deeplink.

Mở app ZaloPay Test quét QR → confirm bằng PIN sandbox.

• Verify order status: Pending → Processing trong 5-10 giây sau confirm.
• Verify callback fire: log /wc-logs/zalopay-{date}.log có entry “callback-success” kèm app_trans_id.
• Verify notification Zalo OA: nếu account test đã follow OA shop, nhận được tin confirm payment trong app Zalo.
• Test 3-5 đơn: happy path + đơn duplicate order_id + đơn timeout — verify toàn bộ edge case trước go-live.

Bước 4 — Go live và custom logic leverage Zalo OA

Sau test sandbox pass, switch Production trong plugin. Test 1 đơn thật từ ví ZaloPay cá nhân của owner — phí 1-2k chấp nhận để verify production flow end-to-end.

Custom 1 — Discount ưu đãi cho follower Zalo OA

Đây là core value proposition của ZaloPay — incentivize khách follow OA để chạy retention sau này. Filter hook check status follower qua API ZaloPay rồi apply discount.

add_action('woocommerce_cart_calculate_fees', 'zalo_oa_follower_discount');

function zalo_oa_follower_discount() {
    if (is_admin() || ! WC()->cart) return;
    $payment = WC()->session->get('chosen_payment_method');
    if ($payment !== 'zalopay') return;

    $is_follower = check_zalo_oa_follower(
        WC()->customer->get_billing_phone()
    );

    if ($is_follower) {
        $subtotal = WC()->cart->get_subtotal();
        $discount = -$subtotal * 0.05;
        WC()->cart->add_fee('Discount Zalo OA (-5%)', $discount, false);
    }
}

Custom 2 — Push reminder cart abandonment qua Zalo OA

Khách add cart nhưng không complete checkout — schedule push notification qua Zalo OA sau 30 phút.

ROI cao hơn email reminder vì tỉ lệ mở Zalo OA 60-80%.

• Trigger event: hook woocommerce_add_to_cart, lưu phone khách vào meta + timestamp.
• Cron job: chạy mỗi 5 phút, query cart age trên 30 phút và chưa checkout, gọi API Zalo OA send message.
• Message template: ngắn gọn 1-2 câu kèm link checkout direct — branded với logo shop.

5 lỗi phổ biến khi tích hợp ZaloPay và cách fix

ZaloPay có 2 key độc lập nên debug signature phức tạp hơn VNPAY 1 chút. Dưới đây là 5 lỗi gặp nhiều nhất khi Web22 tích hợp ZaloPay cho nhiều shop.

• Invalid MAC signature: ZaloPay reject “Invalid MAC”. Re-check Key 1 dùng đúng cho sign request, không nhầm với Key 2.
• Verify thứ tự field trong raw data string theo docs ZaloPay — concat strict không thừa space.
• Callback không fire: firewall hosting block IP ZaloPay. Whitelist range IP 118.69.0.0/16 và 222.255.119.0/24 trong cPanel hoặc Plesk security setting.
• Duplicate order_id trong sandbox: ZaloPay yêu cầu order_id unique trong 24 giờ. Sandbox test nhiều dễ trùng — add timestamp prefix vào order_id: $id = date('YmdHis') . '_' . $order_id;.
• Phí cao bất thường 1,5%: chưa upgrade tier Premium dù volume đã đủ 200 triệu/tháng. Submit doc upgrade qua dashboard → Settings → Pricing Review.
• Settlement chậm cuối tuần: mặc định T+1 ngày làm việc — cuối tuần và lễ delay thêm 1-2 ngày. Check tab Settlement trong dashboard, đối soát số dư cuối tháng cho khớp.

Zalo OA marketing luồng tự động sau khi tích hợp

Tích hợp ZaloPay xong mới là 50% giá trị — 50% còn lại đến từ marketing luồng tự động qua Zalo OA. Setup 3 workflow luồng tự động cơ bản để leverage hết tiềm năng kênh.

3 workflow luồng tự động high-ROI

• Welcome flow follower mới: khách follow OA → tự động gửi welcome message + voucher ưu đãi cho đơn đầu — tăng conversion follower → buyer 15-25%.
• Cart abandonment reminder: add cart không checkout sau 30 phút → push reminder qua OA — recover rate 8-15% so với 3-5% qua email.
• Post-purchase upsell: sau khi delivered 3-7 ngày → đề xuất sản phẩm related qua OA — repeat purchase rate tăng 20-35%.

Đo lường ROI Zalo OA channel

Setup UTM tracking riêng cho mọi link từ Zalo OA — track traffic + conversion riêng channel này trong GA4. Sau 30 ngày có data đủ để justify expand thêm chiến dịch.

• UTM source: set utm_source=zalo_oa cho mọi link push qua OA — tách biệt với organic Zalo traffic.
• Conversion tracking: GA4 enhanced ecommerce track conversion rate + AOV per source — compare Zalo OA với email và paid.
• Cost per acquisition: tính CPA cho follower OA = (chi phí acquire follower) / (conversion follower → buyer) — benchmark với CPA Meta Ads.

Tích hợp đa cổng và bài liên quan

ZaloPay nên đặt tier 2 sau MoMo/VNPAY làm primary. Shop tích hợp 2-3 cổng song song cover hết phân khúc khách hàng — không cần phải tích hợp cả 5.

Tham khảo các cổng còn lại: tích hợp VNPAY cho mass market 40+ banks, tích hợp MoMo cho khách trẻ 18-35 tuổi, tích hợp OnePay cho shop B2B doanh nghiệp lớn.

Trước khi tích hợp payment, ship hardening security đúng chuẩn — xem bảo mật shop WooCommerce 7 lớp để bảo vệ data khách và payment flow.

Câu hỏi thường gặp về tích hợp ZaloPay

Tích hợp ZaloPay + link Zalo OA turnkey

Setup ZaloPay end-to-end + link Zalo OA + custom logic discount follower + cron job reminder cart — cần kiến thức WordPress + PHP + Zalo OA API + cron scheduler. Tự mò mất 5-7 ngày dễ stuck ở debug signature 2 key.

Web22 ship turnkey ZaloPay trong 2-3 ngày, bao gồm cả integration Zalo OA marketing luồng tự động. Tư vấn shop online WooCommerce chuyên nghiệp — báo giá rõ phạm vi, có SLA cam kết thời gian hoạt động và giao đúng hạn.