Nhảy đến nội dung

Giới thiệu

Bán quyền truy cập vào sản phẩm của bạn dưới dạng đăng ký trả phí định kỳ.

🔐 Các phương thức của mô-đun này yêu cầu ủy quyền.

Thông tin thêm về giao diện người dùng của mô-đun https://doc.oneentry.cloud/docs/category/subscriptions

🎯 Mô-đun này làm gì?​

Mô-đun Subscriptions cho phép bạn quản lý các đăng ký trả phí cho người dùng hiện tại - tạo một đăng ký và nhận một phiên thanh toán, hủy nó, khôi phục nó thông qua Cổng Thanh toán Stripe, và liệt kê các dấu hiệu đăng ký có sẵn hoặc đang hoạt động.

Hãy nghĩ về nó như là thanh toán định kỳ cho ứng dụng của bạn - thay vì các đơn hàng một lần, người dùng đăng ký một gói (một "dấu hiệu" như premium) và được tính phí tự động bởi nhà cung cấp thanh toán.

📖 Giải thích đơn giản​

Một quy trình đăng ký thường trông như thế này:

  • 🧾 Gói - Bạn định nghĩa các gói đăng ký (dấu hiệu) trong bảng điều khiển quản trị OneEntry
  • 💳 Đăng ký - Người dùng chọn một gói và được chuyển hướng đến một phiên thanh toán
  • 🔁 Thanh toán định kỳ - Nhà cung cấp thanh toán tự động tính phí người dùng
  • ❌ Hủy - Người dùng hủy và giữ quyền truy cập cho đến khi thời gian kết thúc
  • ♻️ Khôi phục - Người dùng khôi phục một đăng ký đã hủy qua Cổng Thanh toán

✨ Các khái niệm chính​

Dấu hiệu đăng ký là gì?​

Một dấu hiệu là định danh văn bản duy nhất của một gói đăng ký (ví dụ premium). Bạn truyền nó cho mọi phương thức của mô-đun này để cho OneEntry biết bạn đang nói đến gói nào. Các dấu hiệu không bao giờ thay đổi, vì vậy hãy luôn tham chiếu các gói bằng dấu hiệu trong mã của bạn.

Phiên thanh toán​

subscribe() trả về một phiên thanh toán - một đối tượng với paymentUrl mà người dùng phải mở để hoàn tất thanh toán đầu tiên. Chuyển hướng người dùng đến đó để hoàn tất quy trình thanh toán.

📋 Những điều bạn cần biết​

  • Tất cả các phương thức yêu cầu một người dùng đã được ủy quyền - gọi chúng sau khi người dùng đã đăng nhập qua mô-đun AuthProvider.
  • getAllSubscriptions() trả về tất cả các dấu hiệu có sẵn, getActiveSubscriptions() chỉ trả về các dấu hiệu mà người dùng hiện tại đã đăng ký.
  • cancelSubscription() và recoverSubscriptions() trả về true khi thành công.

📊 Bảng tham khảo nhanh​

Phương thứcMô tả
subscribe()Tạo một đăng ký và nhận một phiên thanh toán
getAllSubscriptions()Lấy tất cả các dấu hiệu đăng ký có sẵn
getActiveSubscriptions()Lấy các dấu hiệu của các đăng ký đang hoạt động của người dùng
cancelSubscription()Hủy một đăng ký
recoverSubscriptions()Khôi phục một đăng ký qua Cổng Thanh toán

❓ Câu hỏi thường gặp (FAQ)​

Làm thế nào để tôi tạo một gói đăng ký?​

Các gói đăng ký được cấu hình trong bảng điều khiển quản trị OneEntry và được kết nối với một tài khoản thanh toán (ví dụ Stripe). SDK tham chiếu mỗi gói bằng dấu hiệu của nó.

subscribe() trả về cái gì?​

Nó trả về một phiên thanh toán với paymentUrl. Chuyển hướng người dùng đến URL đó để hoàn tất thanh toán đầu tiên và kích hoạt đăng ký.

Sự khác biệt giữa hủy và khôi phục là gì?​

cancelSubscription() dừng việc thanh toán định kỳ cho một gói. recoverSubscriptions() khôi phục một đăng ký đã hủy trước đó thông qua Cổng Thanh toán Stripe.

🎓 Các thực hành tốt nhất​

  • Luôn tham chiếu các gói bằng dấu hiệu, không bao giờ bằng tên hiển thị.
  • Xác thực người dùng trước khi gọi bất kỳ phương thức đăng ký nào.
  • Sau subscribe(), chuyển hướng người dùng đến paymentUrl và xử lý URL trả về trong ứng dụng của bạn.
  • Sử dụng getActiveSubscriptions() để kiểm soát các tính năng cao cấp trong giao diện người dùng của bạn.

Định nghĩa của mô-đun Subscriptions​


const { Subscriptions } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Tài liệu liên quan​