Nộp giấy tờ chủ sở hữu

Cập nhật lần cuối: 05/03/2026

Được sử dụng để nộp giấy tờ cá nhân. Khác với giấy tờ doanh nghiệp, giấy tờ cá nhân được tải lên trực tiếp dưới dạng byte array trong một bước duy nhất (single-phase process).

Parameters

Property	Type	Required	Description
miniAppId	Long	true	ID của Mini App
ownerDocumentFiles	List<DocumentFile>	true	Danh sách tệp giấy tờ (byte array). SDK Node.js gửi dạng form-data upload.

DocumentFile

Property	Type	Required	Description
file	byte[]	true	Nội dung tệp dưới dạng byte array
name	String	true	Tên tệp

Return Values

Property	Type	Description
error	int	Mã lỗi của kết quả trả về, bằng 0 nếu request thành công
message	String	Lời nhắn chi tiết tương ứng với mã lỗi
data	Object	Kết quả nộp giấy tờ

Lưu ý

• Nếu đã có yêu cầu xác thực chủ sở hữu trước đó, API sẽ trả về lỗi:
  • error: -101
  • message: "Đã có yêu cầu xác thực chủ sở hữu"
• Nếu ứng dụng chưa cập nhật subCateIds, API sẽ trả về lỗi:
  • message: "Vui lòng cập nhật thông tin"
  • Vui lòng sử dụng API Cập nhật loại hình để cập nhật subCateIds. Có thể lấy danh sách subCateIds hợp lệ từ API Lấy thông tin Mini App.

Data Object

Property	Type	Description
ownerDocumentResults	Document	Kết quả cho giấy tờ cá nhân

Document

Property	Type	Description
id	Long	ID của request
reviewStatus	String	Trạng thái xét duyệt
ownerId	String	ID của chủ sở hữu
createdAt	Long	Thời gian tạo
documentFiles	List<DocumentFile>	Danh sách tệp giấy tờ

Sample Code

Code demo fallback when rendering server side!