Tài liệu VietBilling
Tích hợp subscription billing trên PayOS bằng Public API và webhook.
Tích hợp subscription billing theo một luồng rõ ràng
VietBilling nối ứng dụng SaaS của bạn với PayOS: ứng dụng tạo Customers và Checkouts, khách hàng thanh toán qua PayOS, sau đó webhook cập nhật Subscriptions và BenefitGrants.
- Tạo Organization và kết nối tài khoản PayOS.
- Tạo recurring Product cùng ProductPrice và Benefits.
- Tạo API key và webhook endpoint.
- Tạo customer, mở checkout, rồi đồng bộ subscription từ webhook.
Lộ trình đề xuất
Nếu đây là lần tích hợp đầu tiên, hãy đọc Bắt đầu tích hợp, Xác thực API, Checkout, rồi Webhooks.
Nguyên tắc đồng bộ
VietBilling là nguồn trạng thái billing và BenefitGrants. Ứng dụng của bạn vẫn là nguồn dữ liệu người dùng và nơi enforce quyền. Lưu customer_id, subscription_id và event id; chỉ cấp hoặc thu hồi quyền khi đã xử lý event hợp lệ.