Products & ProductPrices

Mô hình hóa plan định kỳ trước khi viết Checkout code.

Tạo Products và versioned ProductPrices trong dashboard, sau đó gửi product_id ổn định từ backend.

Bắt đầu miễn phí

Kết quả

Catalog và Checkout dùng chung một nguồn cấu hình thay vì hard-code giá trong frontend.

Tạo Product

Đặt tên plan và mô tả giá trị khách hàng nhận được.

Thêm ProductPrice

Chọn fixed VND amount và cadence tháng hoặc năm.

Dùng product_id

Lưu Product ID ở server và gửi khi tạo Checkout.

Tích hợp từ backend

API key là secret của server. Không đặt key trong browser hoặc mobile app.

const checkout = await billing.checkout.create({
  customer_id: customerId,
  product_id: process.env.VIETBILLING_PRODUCT_ID,
  success_url: "https://app.example/success",
  cancel_url: "https://app.example/cancel"
})

FAQ

Có nên để product_id ở frontend?

Nên tạo Checkout từ backend và kiểm soát Products phía server.

Có thể đổi ProductPrice đang sử dụng không?

Đổi giá sẽ tạo ProductPrice mới để lịch sử và Subscription hiện tại giữ nguyên snapshot.