Đăng ký

​

Đăng Ký Là Gì?

• Giấy phép SaaS: Ứng dụng, API hoặc quyền truy cập nền tảng
• Thành viên: Cộng đồng, chương trình hoặc câu lạc bộ
• Nội dung kỹ thuật số: Khóa học, phương tiện hoặc nội dung cao cấp
• Kế hoạch hỗ trợ: SLA, gói thành công hoặc bảo trì

​

Lợi Ích Chính

• Doanh thu dự đoán: Thanh toán định kỳ với việc gia hạn tự động
• Chu kỳ linh hoạt: Hàng tháng, hàng năm, khoảng thời gian tùy chỉnh và thử nghiệm
• Tính linh hoạt của kế hoạch: Phân bổ cho nâng cấp và hạ cấp
• Bổ sung và chỗ ngồi: Gắn các nâng cấp tùy chọn, có thể định lượng
• Thanh toán liền mạch: Thanh toán được lưu trữ và cổng thông tin khách hàng
• Ưu tiên cho nhà phát triển: API rõ ràng cho việc tạo, thay đổi và theo dõi sử dụng

​

Tạo Đăng Ký

​

Tạo sản phẩm đăng ký

​

Chi tiết sản phẩm

• Tên sản phẩm (bắt buộc): Tên hiển thị được hiển thị trong thanh toán, cổng thông tin khách hàng và hóa đơn.
• Mô tả sản phẩm (bắt buộc): Một tuyên bố giá trị rõ ràng xuất hiện trong thanh toán và hóa đơn.
• Hình ảnh sản phẩm (bắt buộc): PNG/JPG/WebP tối đa 3 MB. Được sử dụng trên thanh toán và hóa đơn.
• Thương hiệu: Liên kết sản phẩm với một thương hiệu cụ thể để tạo chủ đề và email.
• Danh mục thuế (bắt buộc): Chọn danh mục (ví dụ: SaaS) để xác định quy tắc thuế.

​

Giá cả

• Loại giá: Chọn Đăng ký (hướng dẫn này). Các lựa chọn thay thế là Thanh toán một lần và Thanh toán theo mức sử dụng.
• Giá (bắt buộc): Giá cơ bản định kỳ với đơn vị tiền tệ.
• Giảm giá áp dụng (%): Phần trăm giảm giá tùy chọn áp dụng cho giá cơ bản; được phản ánh trong thanh toán và hóa đơn.
• Lặp lại thanh toán mỗi (bắt buộc): Khoảng thời gian cho việc gia hạn, ví dụ, mỗi 1 tháng. Chọn nhịp (tháng hoặc năm) và số lượng.
• Thời gian đăng ký (bắt buộc): Tổng thời gian mà đăng ký vẫn còn hiệu lực (ví dụ, 10 năm). Sau khi thời gian này kết thúc, việc gia hạn sẽ dừng lại trừ khi được gia hạn.
• Số ngày thử nghiệm (bắt buộc): Đặt độ dài thử nghiệm tính bằng ngày. Sử dụng 0 để vô hiệu hóa thử nghiệm. Khoản phí đầu tiên sẽ tự động xảy ra khi thử nghiệm kết thúc.
• Chọn tiện ích bổ sung: Gắn tối đa 10 tiện ích bổ sung mà khách hàng có thể mua cùng với gói cơ bản.

​

Cài đặt nâng cao

• Giá bao gồm thuế: Hiển thị giá bao gồm thuế áp dụng. Tính toán thuế cuối cùng vẫn thay đổi theo vị trí của khách hàng.
• Tạo khóa giấy phép: Cấp một khóa duy nhất cho mỗi khách hàng sau khi mua. Xem hướng dẫn Khóa Giấy Phép.
• Giao hàng sản phẩm kỹ thuật số: Giao tệp hoặc nội dung tự động sau khi mua. Tìm hiểu thêm trong Giao hàng sản phẩm kỹ thuật số.
• Siêu dữ liệu: Gắn các cặp khóa–giá trị tùy chỉnh cho việc gán nhãn nội bộ hoặc tích hợp khách hàng. Xem Siêu dữ liệu.

​

Thử Nghiệm Đăng Ký

​

Cấu Hình Thử Nghiệm

// Via subscription creation
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_monthly',
  trial_period_days: 14  // Overrides product's trial period
});

// Via checkout session
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_monthly', quantity: 1 }],
  subscription_data: { trial_period_days: 14 }
});

​

Phát Hiện Trạng Thái Thử Nghiệm

const subscription = await client.subscriptions.retrieve('sub_123');
const payments = await client.payments.list({
  subscription_id: subscription.subscription_id
});

// Check if subscription is in trial
const isInTrial = payments.items.length === 1 && 
                  payments.items[0].total_amount === 0;

​

Cập Nhật Thời Gian Thử Nghiệm

await client.subscriptions.update('sub_123', {
  next_billing_date: '2025-02-15T00:00:00Z'  // New trial end date
});

​

Thay Đổi Kế Hoạch Đăng Ký

​

Chế Độ Phân Bổ Tỷ Lệ

​

prorated_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

​

difference_immediately

// Upgrade: charges $50 (difference between $30 and $80)
// Downgrade: credits remaining value, auto-applied to renewals
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

full_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_monthly',
  quantity: 1,
  proration_billing_mode: 'full_immediately'
});

Unused credit from Basic = $30 × (15 remaining / 30 total) = $15.00
Prorated cost of Pro     = $80 × (15 remaining / 30 total) = $40.00
────────────────────────────────────────────────────────────────────
Immediate charge         = $40.00 − $15.00 = $25.00

Credit = Old plan − New plan = $80 − $20 = $60.00

​

Thay đổi Gói với Tiện ích Mở rộng

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [{ addon_id: 'addon_extra_seats', quantity: 2 }]  // Add add-ons
  // addons: []  // Empty array removes all existing add-ons
});

​

Xem trước Việc thay đổi Gói

const preview = await client.subscriptions.previewChangePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

// Show customer the charge before confirming
console.log('You will be charged:', preview.immediate_charge.summary);

​

Các Trạng thái Đăng ký

• active: Đăng ký đang hoạt động và sẽ tự động gia hạn
• on_hold: Đăng ký bị tạm ngưng do thanh toán thất bại. Cần cập nhật phương thức thanh toán để kích hoạt lại
• cancelled: Đăng ký đã bị hủy và sẽ không được gia hạn
• expired: Đăng ký đã đến ngày kết thúc
• pending: Đăng ký đang được tạo hoặc xử lý

​

Trạng thái Tạm ngưng

• Một khoản thanh toán gia hạn thất bại (không đủ tiền, thẻ hết hạn, v.v.)
• Một khoản phí thay đổi gói thất bại
• Ủy quyền phương thức thanh toán thất bại

​

Kích hoạt lại từ Trạng thái Tạm ngưng

1. Tạo một khoản phí cho số tiền còn nợ
2. Tạo hóa đơn
3. Xử lý thanh toán bằng phương thức mới
4. Kích hoạt lại đăng ký sang trạng thái active khi thanh toán thành công

// Reactivate subscription from on_hold
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// For on_hold subscriptions, a charge is automatically created
if (response.payment_id) {
  console.log('Charge created:', response.payment_id);
  // Redirect customer to response.payment_link to complete payment
  // Monitor webhooks for payment.succeeded and subscription.active
}

​

Quản lý API

​

Cập nhật phương thức thanh toán cho đăng ký đang hoạt động

// Update with new payment method
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

​

Kích hoạt lại đăng ký từ tạm dừng

// Update payment method - automatically creates charge for remaining dues
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

​

Đăng ký với các mệnh lệnh tuân thủ RBI

​

Giới hạn mệnh lệnh

​

Các Trường hợp Sử dụng Chung

• SaaS và API: Truy cập theo tầng với tiện ích mở rộng cho ghế ngồi hoặc sử dụng
• Nội dung và truyền thông: Truy cập hàng tháng với thử nghiệm giới thiệu
• Gói hỗ trợ B2B: Hợp đồng hàng năm với tiện ích hỗ trợ cao cấp
• Công cụ và plugin: Khóa giấy phép và phát hành theo phiên bản

​

Ví dụ Tích hợp

​

Phiên thanh toán (đăng ký)

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_subscription',
      quantity: 1
    }
  ]
});

​

Thay đổi gói với phân bổ tỷ lệ

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

Hủy vào ngày thanh toán tiếp theo

await client.subscriptions.update('sub_123', {
  cancel_at_next_billing_date: true
});

​

Đăng ký theo yêu cầu

const onDemand = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_on_demand',
  on_demand: true
});

await client.subscriptions.createCharge(onDemand.id, {
  amount: 4900,
  currency: 'USD',
  description: 'Extra usage for September'
});

​

Cập nhật phương thức thanh toán cho đăng ký đang hoạt động

// Update with new payment method
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

​

Kích hoạt lại đăng ký từ on_hold

// Update payment method - automatically creates charge for remaining dues
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

​

Đăng ký với Ủy nhiệm Tuân thủ RBI

​

Giới hạn Ủy nhiệm

• Các khoản dưới Rs 15,000: Chúng tôi tạo ủy nhiệm theo yêu cầu cho Rs 15,000 INR. Số tiền đăng ký được tính định kỳ theo tần suất của bạn, tối đa đến giới hạn ủy nhiệm.
• Các khoản Rs 15,000 trở lên: Chúng tôi tạo ủy nhiệm đăng ký (hoặc ủy nhiệm theo yêu cầu) cho đúng số tiền đăng ký.

​

Cân nhắc khi nâng cấp và hạ cấp

• Nếu nâng/hạ cấp dẫn đến số tiền vượt Rs 15,000 và vượt giới hạn thanh toán theo yêu cầu hiện tại, giao dịch có thể thất bại.
• Trong trường hợp đó, khách hàng có thể cần cập nhật phương thức thanh toán hoặc thay đổi đăng ký lần nữa để thiết lập ủy nhiệm mới với giới hạn đúng.

​

Ủy quyền cho các khoản phí giá trị cao

• Ngân hàng sẽ yêu cầu khách hàng ủy quyền giao dịch.
• Nếu khách hàng không ủy quyền, giao dịch sẽ thất bại và đăng ký sẽ bị tạm ngưng.

​

Độ trễ xử lý 48 giờ

• Các khoản phí được khởi tạo vào ngày theo lịch trình tần suất đăng ký của bạn.
• Việc khấu trừ thực tế từ tài khoản khách hàng chỉ xảy ra sau 48 giờ kể từ khi khởi tạo thanh toán.
• Khoảng thời gian 48 giờ này có thể kéo dài thêm 2-3 giờ tùy phản hồi API ngân hàng.

​

Khoảng thời gian Hủy ủy nhiệm

• Khách hàng có thể hủy ủy nhiệm qua ứng dụng ngân hàng.
• Nếu khách hàng hủy trong khoảng này, đăng ký sẽ vẫn hoạt động (đây là trường hợp đặc biệt dành riêng cho thẻ Ấn Độ và đăng ký UPI AutoPay).
• Tuy nhiên, việc khấu trừ thực tế có thể thất bại, và trong trường hợp đó, chúng tôi sẽ đặt đăng ký tạm ngưng.

• Hoãn kích hoạt quyền lợi cho đến khi xác nhận thanh toán
• Áp dụng thời gian ân hạn hoặc truy cập tạm thời
• Theo dõi trạng thái đăng ký để xử lý hủy ủy nhiệm
• Xử lý trạng thái tạm ngưng đăng ký trong logic ứng dụng của bạn

​

Các Thực hành Tốt nhất

• Bắt đầu với các cấp rõ ràng: 2–3 gói với sự khác biệt rõ ràng
• Truyền đạt giá: Hiển thị tổng, phân bổ tỷ lệ và lần gia hạn tiếp theo
• Sử dụng thử một cách có suy nghĩ: Chuyển đổi bằng hướng dẫn khởi tạo, không chỉ dựa vào thời gian
• Tận dụng tiện ích: Giữ các gói cơ bản đơn giản và bán thêm tiện ích
• Thử nghiệm thay đổi: Xác thực thay đổi gói và phân bổ tỷ lệ ở chế độ thử nghiệm