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.
Đâ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
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ện | Backend cần làm gì |
|---|---|
| DID_RENEW / gia hạn thành công | Gia 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ại | Có 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ền | Thu 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ế 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
-
Apple — App Store Server API & NotificationsTài liệu chính thức API xác thực và webhook của AppleDocs
-
Google Play — Real-time developer notificationsTài liệu chính thức RTDN của Google Play BillingDocs
-
RevenueCat — Subscription infrastructure (tham khảo dịch vụ bên thứ ba)Dịch vụ phổ biến giúp đơn giản hoá xử lý subscription đa nền tảngDocs
✅ 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