Tạo tài khoản Simplize

API này dùng để đăng ký một tài khoản người dùng mới trên nền tảng Simplize cho một người dùng từ hệ thống của đối tác.

HTTP request

• URL: /api/general/v1/partner/users/register
• Method: POST
• Content Type: None
• Response Type: application/json

Tham số header

Header	Mô tả	Kiểu dữ liệu	Bắt buộc
X-Api-Key	Khóa duy nhất.	string	có

Tham Số Truy Vấn (Query Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
externalUserId	string	có	ID người dùng duy nhất từ hệ thống của đối tác.
recvWindow	string	không	Thời gian chấp nhận (ms), default: 5000
timestamp	string	có	Unix timestamp (milliseconds).
signature	string	có	HMAC-SHA256 signature.

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "data": {
    "id": 14,
    "userId": 1413,
    "externalUserId": "USER012",
    "status": "ACTIVE",
    "createdDate": "2025-12-16T04:50:44.513Z"
  }
}

Chi Tiết Tham Số Response

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	number	Mã trạng thái HTTP.
message	string	Thông báo kết quả xử lý.
data	object (Xem chi tiết)	Dữ liệu tài khoản người dùng đã được tạo.

Cấu trúc thuộc tính data

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
id	number	ID duy nhất của người dùng trên hệ thống Simplize.
userId	string	User Id người dùng từ hệ thống của Simplize.
externalUserId	string	UserId của đối tác.
status	string	Trạng thái tài khoản: - ACTIVE: Hoạt động - INACTIVE: Không hoạt động
createdDate	string	Thời gian tạo tài khoản (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').