Mobile Engineering for Backend Engineers
Trang chủ / Module 10
💳 Module 10 / 14 · 1-2 tuần

In-App Purchase & Subscription

StoreKit (Apple) và Google Play Billing, xác thực receipt/giao dịch ở backend, và xử lý webhook cho vòng đời subscription.

StoreKitPlay BillingWebhook
📌 Vì sao module này quan trọng

Đây là module có nhiều cạm bẫy kỹ thuật và pháp lý nhất trong toàn khoá — tự xử lý sai vòng đời subscription (không phát hiện huỷ/hết hạn kịp thời) khiến người dùng tiếp tục dùng tính năng trả phí dù đã ngừng thanh toán, gây thiệt hại tài chính trực tiếp cho doanh nghiệp.

🎯 Mục tiêu học tập

  • Hiểu luồng giao dịch cơ bản qua StoreKit (iOS) và Google Play Billing (Android)
  • Xác thực receipt/giao dịch ở backend đúng cách, không tin tưởng dữ liệu client tự gửi lên
  • Xử lý webhook (App Store Server Notifications, Real-time Developer Notifications) cho vòng đời subscription
  • Thiết kế hệ thống đồng bộ trạng thái subscription đáng tin cậy giữa store và backend

Luồng Giao dịch qua StoreKit & Play Billing

Giao dịch mua hàng trong app luôn đi qua chính nền tảng (Apple/Google), không phải thẳng đến backend của bạn: app hiển thị danh sách sản phẩm (đã khai báo sẵn trên App Store Connect/Play Console), người dùng xác nhận mua qua giao diện hệ thống, Apple/Google xử lý thanh toán thật (trừ tiền qua phương thức đã lưu của người dùng), rồi trả về 1 "receipt"/"purchase token" cho app — backend chỉ thấy giao dịch sau khi nó đã hoàn tất, không tham gia vào bước thanh toán trực tiếp.

App (StoreKit/Billing) → Apple/Google xử lý thanh toán
                          → trả về receipt/purchase token cho App
                          → App gửi receipt/token lên Backend
                          → Backend XÁC THỰC lại với Apple/Google (bước bắt buộc, xem phần dưới)

Xác thực Receipt/Giao dịch — Không bao giờ Tin Client

⚠️ Lỗi bảo mật nghiêm trọng phổ biến nhất

Chỉ tin tưởng App gửi lên "tôi đã mua thành công" mà không xác thực lại với server của Apple/Google là lỗ hổng cho phép giả mạo giao dịch hoàn toàn (receipt giả, replay lại 1 receipt cũ) — đúng nguyên lý "không bao giờ tin client" đã nhấn mạnh ở Module 8, áp dụng nghiêm ngặt nhất ở chính module này vì liên quan trực tiếp đến tiền thật.

# Backend PHẢI gọi API xác thực chính thức, không tự parse/tin receipt client gửi lên
# iOS: gọi App Store Server API để verify transaction
# Android: gọi Google Play Developer API để verify purchase token

response = verify_with_apple_or_google(receipt_data)
if response.is_valid and response.product_id == expected_product_id:
    grant_entitlement(user_id, product_id)
else:
    reject_and_log_suspicious_activity(user_id)

Webhook cho Vòng đời Subscription

Subscription không phải giao dịch 1 lần — có vòng đời phức tạp: gia hạn tự động, người dùng huỷ (nhưng vẫn dùng được đến hết chu kỳ đã trả tiền), thanh toán gia hạn thất bại (thẻ hết hạn), hoàn tiền, chuyển đổi gói. App Store Server Notifications (Apple) và Real-time Developer Notifications — RTDN (Google) là webhook chính thức thông báo các sự kiện này ngay khi xảy ra, thay vì phải tự polling kiểm tra định kỳ:

Sự kiệnBackend cần làm gì
DID_RENEW / gia hạn thành côngGia hạn thời hạn truy cập tính năng trả phí cho user
DID_FAIL_TO_RENEW / gia hạn thất bạiCó thể cho ân hạn (grace period) vài ngày trước khi khoá tính năng, tuỳ chính sách sản phẩm
CANCEL / người dùng huỷKHÔNG khoá ngay — vẫn giữ quyền truy cập đến hết chu kỳ đã trả tiền, chỉ đánh dấu không tự gia hạn tiếp
REFUND / hoàn tiềnThu hồi quyền truy cập ngay lập tức

Đăng ký endpoint webhook này là bước bắt buộc để hệ thống subscription hoạt động đáng tin cậy — thiếu nó, cách duy nhất biết trạng thái subscription là chờ app tự gọi lên xác thực lại (không đáng tin cậy, vì app có thể không mở trong nhiều ngày sau khi huỷ).

Đồng bộ Trạng thái Subscription đáng tin cậy

Thiết kế bảng dữ liệu subscription cần lưu đủ: trạng thái hiện tại (active/canceled/expired/in grace period), thời điểm hết hạn chu kỳ hiện tại, và lịch sử sự kiện (để hỗ trợ khách hàng khi có tranh chấp). Nên có job định kỳ đối soát lại (reconciliation — liên hệ khoá DevOps, Module 13: cron/systemd timer) gọi API xác thực chính thức để phát hiện trường hợp webhook bị lỗi/mất (mạng lỗi, endpoint tạm thời down) — không nên tin tưởng webhook là kênh thông tin duy nhất và tuyệt đối không bao giờ lỗi.

🏋️ Bài tập thực hành

Thiết kế Hệ thống Subscription hoàn chỉnh

Thiết kế schema database cho subscription (trạng thái, thời hạn, lịch sử sự kiện). Viết endpoint nhận webhook giả lập từ App Store Server Notifications/RTDN, xử lý đúng các sự kiện chính (renew, cancel, refund) theo đúng chính sách (không khoá ngay khi cancel, khoá ngay khi refund). Thiết kế 1 job đối soát định kỳ kiểm tra lại trạng thái với API chính thức của Apple/Google.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Hiểu đúng luồng giao dịch qua StoreKit/Play Billing và vai trò giới hạn của backend
  • Luôn xác thực lại receipt/giao dịch với API chính thức, không tin dữ liệu client tự gửi
  • Xử lý đúng các sự kiện webhook chính cho vòng đời subscription
  • Thiết kế được job đối soát định kỳ, không phụ thuộc hoàn toàn vào webhook