VietBilling
VietBilling Docs

Subscriptions

Quản lý trạng thái, entitlement và chu kỳ gia hạn subscription.

Subscription là trạng thái billing, entitlement là quyết định của ứng dụng

Lưu subscription_id, status, Product, snapshot ProductPrice và thời điểm kết thúc kỳ hiện tại. Query BenefitGrants khi ứng dụng cần entitlement hiện hành.

const subscription = await fetch(
  `${apiUrl}/public/v2/subscriptions/${subscriptionId}`,
  { headers: apiHeaders },
).then((res) => res.json())

Trạng thái và quyền truy cập

Chỉ cấp quyền sau Checkout hợp lệ và event Subscription tương ứng. active và trạng thái recovery past_due giữ BenefitGrants; canceled thu hồi grants.

Chu kỳ gia hạn

PayOS không tự động trừ tiền định kỳ. Trước kỳ hạn, VietBilling tạo pending Order, Checkout và Payment attempt. Khi thanh toán succeeded, các event order.paid, payment.succeeded, checkout.succeeded và subscription.updated cập nhật kỳ tiếp theo.

  1. Lưu mỗi webhook event id theo cách idempotent.
  2. Hiển thị hoặc gửi renewal Checkout URL qua kênh của bạn.
  3. Nhận subscription.updated sau khi Payment succeeded.
  4. Cập nhật kỳ hiện tại và refresh BenefitGrants.

Đừng gia hạn chỉ vì người dùng mở renewal URL.