Đă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 dựa trên mức sử dụng.
• Giá (bắt buộc): Giá định kỳ cơ bản với đơn vị tiền tệ.
• Giảm giá áp dụng (%): Giảm giá phần trăm 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 hoạt động (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 theo ngày. Sử dụng 0 để vô hiệu hóa thử nghiệm. Khoản phí đầu tiên sẽ xảy ra tự động khi thử nghiệm kết thúc.
• Chọn bổ sung: Gắn tối đa 3 bổ sung mà khách hàng có thể mua cùng với kế hoạch 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ổ

​

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'
});

​

Thay Đổi Kế Hoạch Với Bổ Sung

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 Thay Đổi Kế Hoạch

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);

​

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 dừng do thanh toán không thành công. 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 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 Dừng

• Một khoản thanh toán gia hạn không thành công (thiếu tiền, thẻ hết hạn, v.v.)
• Một khoản phí thay đổi kế hoạch không thành công
• Việc ủy quyền phương thức thanh toán không thành công

​

Kích Hoạt Lại Từ Trạng Thái Tạm Dừng

1. Tạo một khoản phí cho các khoản nợ còn lại
2. Tạo một hóa đơn
3. Xử lý thanh toán bằng phương thức thanh toán 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ác Trường Hợp Sử Dụng Thông Thường

• SaaS và API: Quyền truy cập theo cấp độ với các bổ sung cho chỗ ngồi hoặc mức sử dụng
• Nội dung và phương tiện: Quyền truy cập hàng tháng với các thử nghiệm giới thiệu
• Kế hoạch hỗ trợ B2B: Hợp đồng hàng năm với các bổ sung hỗ trợ cao cấp
• Công cụ và plugin: Khóa giấy phép và các phiên bản có 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 kế hoạch với phân bổ

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

​

Hủy vào cuối kỳ

await client.subscriptions.update('sub_123', {
  cancel_at_period_end: 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ừ trạng thái 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 khoản phí dưới ₹15,000: Chúng tôi tạo một mệnh lệnh theo yêu cầu cho ₹15,000 INR. Số tiền đăng ký được tính phí định kỳ theo tần suất đăng ký của bạn, lên đến giới hạn mệnh lệnh.
• Các khoản phí ₹15,000 trở lên: Chúng tôi tạo một mệnh lệnh đăng ký (hoặc mệnh lệnh theo yêu cầu) cho số tiền đăng ký chính xác.

​

Cân Nhắc Nâng Cấp và Hạ Cấp

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

​

Ủy Quyền Cho Các Khoản Phí Giá Trị Cao

• Khách hàng sẽ được ngân hàng của họ yêu cầu ủy quyền cho giao dịch.
• Nếu khách hàng không ủy quyền cho giao dịch, giao dịch sẽ không thành công và đăng ký sẽ bị tạm dừng.

​

Độ Trễ Xử Lý 48 Giờ

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

​

Cửa Sổ Hủy Mệnh Lệnh

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

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

​

Thực Hành Tốt Nhất

• Bắt đầu với các cấp rõ ràng: 2–3 kế hoạch với sự khác biệt rõ ràng
• Giao tiếp giá cả: Hiển thị tổng, phân bổ và lần gia hạn tiếp theo
• Sử dụng thử nghiệm một cách hợp lý: Chuyển đổi với việc hướng dẫn, không chỉ thời gian
• Tận dụng các bổ sung: Giữ các kế hoạch cơ bản đơn giản và bán thêm các tiện ích
• Kiểm tra các thay đổi: Xác thực các thay đổi kế hoạch và phân bổ trong chế độ thử nghiệm