Nhảy đến nội dung

API đăng ký

Để làm việc với các đăng ký từ phía ứng dụng khách, có ba điểm cuối: đăng ký, hủy đăng ký và nhận danh sách các đăng ký hoạt động của người dùng hiện tại.

Tất cả các điểm cuối đều được thực hiện từ danh nghĩa của người dùng đã xác thực — đăng ký luôn gắn liền với mã thông báo mà yêu cầu đã được thực hiện.

Đăng ký

Tạo một đăng ký mới cho người dùng hiện tại với mã thông báo đã chỉ định.

Hành vi phụ thuộc vào loại tài khoản thanh toán gắn liền với đăng ký trong cài đặt mô-đun:

  • stripe, midtrans — một bản ghi về đăng ký được tạo và trả về liên kết thanh toán. Đăng ký sẽ trở thành hoạt động sau khi việc trừ tiền từ nhà cung cấp thành công.
  • custom — đăng ký được tạo và ngay lập tức được coi là hoạt động. Liên kết thanh toán không được trả về, việc thanh toán được ghi nhận bởi quản trị viên một cách thủ công qua thẻ người dùng.

Hủy đăng ký

Ngừng ngay lập tức đăng ký hoạt động của người dùng.

Hành vi phụ thuộc vào loại tài khoản thanh toán:

  • stripe, midtrans — đăng ký bị hủy qua API của nhà cung cấp: việc trừ tiền tự động sẽ ngừng lại, trạng thái của đăng ký sẽ thay đổi thành canceled.
  • custom — việc hủy qua API không khả dụng. Những đăng ký như vậy chỉ có thể bị hủy bởi quản trị viên qua thẻ người dùng.
thông tin

Cố gắng hủy đăng ký custom qua API sẽ trả về lỗi. Điều này được thực hiện có chủ đích: các đăng ký thủ công được quản lý bởi quản trị viên, vì các khoản thanh toán cho chúng diễn ra ngoài hệ thống.

Nhận các đăng ký hoạt động

Trả về một mảng mã thông báo của các đăng ký hoạt động của người dùng hiện tại.

Đăng ký được coi là hoạt động nếu:

  • Nó đã được đăng ký thành công.
  • Thời gian hiện tại của nó chưa hết hạn.
  • Nó chưa bị hủy (canceled).

Nếu đăng ký hết hạn hoặc đã bị hủy, mã thông báo của nó sẽ tự động biến mất khỏi danh sách. Điểm cuối này rất tiện lợi để sử dụng trên phía khách hàng để kiểm tra quyền truy cập vào nội dung: nếu trong mảng có mã thông báo của đăng ký cần thiết — quyền truy cập sẽ được cấp.