1. Quy trình Xác thực

Luồng đăng nhập qua RentID (OAuth 2.0) diễn ra qua 4 bước cơ bản:

1. Chuyển hướng: Khi người dùng bấm "Đăng nhập bằng RentID", ứng dụng chuyển hướng họ sang trang đăng nhập của RentID.
2. Người dùng đồng ý: Người dùng đăng nhập tài khoản và nhấn xác nhận cho phép ứng dụng truy cập thông tin của họ.
3. Nhận mã xác thực: RentID chuyển hướng người dùng quay lại website của bạn kèm theo một mã xác thực tạm thời (code).
4. Hoàn tất đăng nhập: Máy chủ (Backend) của bạn dùng mã xác thực này để lấy thông tin tài khoản người dùng và hoàn tất phiên đăng nhập.

2. Bước 1: Yêu cầu Ủy quyền (Authorization Request)

Khi người dùng nhấp vào nút "Đăng nhập bằng RentID" trên hệ thống của bạn, hãy chuyển hướng trình duyệt của họ đến đường dẫn:

3. Bước 2: Đổi mã Code lấy Access Token

Sau khi người dùng đồng ý cấp quyền, RentID sẽ chuyển hướng về redirect_uri?code=AUTH_CODE&state=STATE. Backend của bạn thực hiện một request POST tới endpoint sau:

curl -X POST "https://rentid.vn/oauth/token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "client_id": "01a115cc-2fb6-712d-9127-d39ca860774f",
    "client_secret": "fbk8T6YIhHw61nqFwAxg65aPnAG2zGI2J3UtujxT",
    "redirect_uri": "https://partner-domain.com/auth/rentid/callback",
    "code": "def5020058e3..."
  }'

Dữ liệu JSON trả về khi thành công (HTTP 200):

{
  "token_type": "Bearer",
  "expires_in": 1296000,
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
  "refresh_token": "def50200..."
}

4. Bước 3: Lấy Thông tin Người dùng (User Profile API)

Sau khi có access_token, hệ thống của bạn gửi request với Header Authorization Bearer để nhận thông tin định danh:

curl -X GET "https://rentid.vn/api/user" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." \
  -H "Accept: application/json"

Dữ liệu Profile trả về (Ví dụ khi ứng dụng yêu cầu scope=profile email phone):

{
  "status": 200,
  "success": true,
  "message": "Lấy thông tin người dùng RentID thành công.",
  "data": {
    "id": 105,
    "full_name": "Nguyễn Văn An",
    "avatar_url": "https://core.rentid.vn/storage/avatars/user_105.jpg",
    "account_type": "individual",
    "email": "an.nguyen@example.com",
    "email_verified_at": "2026-08-15T08:30:00.000000Z",
    "phone": "0987654321",
    "phone_verified_at": "2026-08-15T08:35:00.000000Z"
  }
}

5. Danh sách Quyền (Scopes) Hỗ trợ

RentID áp dụng nguyên tắc kiểm soát dữ liệu tối thiểu (Principle of Least Privilege). Endpoint /api/user sẽ chỉ trả về những trường tương ứng với Scopes mà ứng dụng của bạn yêu cầu và được người dùng đồng ý: