Hủy kích hoạt Soft OTP

Vô hiệu hóa SmartOTP đang hoạt động của người dùng. Dùng nó trước khi chuyển SmartOTP sang một thiết bị mới, hoặc khi một thiết bị bị mất.

Endpoint

POST /api/v1/saas-sotp/retire
Content-Type: application/json

{
  "partner_id": "{{partner_id}}",
  "partner_key": "{{partner_key}}",
  "token": "{{token}}"
}

Tham số:

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
partner_id	string	Có	—	Partner ID.
partner_key	string	Có	—	Partner key.
token	string	Có	—	Token đăng ký được tạo bởi Đăng ký.

Trả về: RetireResponse

Ví dụ request

curl --location --request POST '<BASE_URL>/saas-sotp/retire' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data-raw '{
    "partner_id": "{{partner_id}}",
    "partner_key": "{{partner_key}}",
    "token": "{{token}}"
  }'

Response

{
  "success": true,
  "code": 1,
  "message": "Success"
}

Trường	Kiểu	Mô tả
success	bool	Trạng thái của request.
code	int	status code — 1 khi thành công.
message	string	Thông báo trạng thái hoặc lỗi.

WARNING

Việc hủy kích hoạt sẽ vô hiệu hóa secret của thiết bị ngay lập tức — mọi mã nó tạo ra sau đó đều sẽ xác minh thất bại. Hãy đảm bảo người dùng có một phương thức xác thực thay thế trước khi bạn hủy kích hoạt thiết bị đã đăng ký duy nhất của họ.

Lỗi

Mã	Mô tả
3	Parameter invalid
103	Thông tin Partner không chính xác — Partner details are incorrect.
126	Có lỗi xảy ra vui lòng thử lại — An error occurred, please retry.
129	Token không hợp lệ — Invalid token.

Bước tiếp theo

• Đăng ký — đăng ký thiết bị thay thế
• Lấy trạng thái — xác nhận việc hủy kích hoạt đã có hiệu lực