API Tạo Công ty

API tạo công ty mới trong hệ thống Bank Hub. Cho phép tạo công ty với tên và trạng thái ban đầu.

POST

https://bankhub-api-sandbox.sepay.vn/v1/company/create

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request Body

Tên	Loại	Bắt buộc	Mô tả
`full_name`	string	Bắt buộc	Tên đầy đủ của công ty. Tối đa 200 ký tự.
`status`	string	Bắt buộc	Trạng thái ban đầu của công ty. Giá trị: `Active` hoặc `Pending`.

Headers

Tên	Loại	Bắt buộc	Mô tả
`Authorization`	Bearer Token	Bắt buộc	Access token lấy từ API /v1/token
`Content-Type`	string	Bắt buộc	application/json

Lưu ý

API này yêu cầu Bearer Token trong header Authorization
Tên công ty phải là duy nhất trong phạm vi merchant
Status nên được set là Active khi tạo để công ty có thể sử dụng ngay
Công ty sau khi tạo sẽ nhận được một xid duy nhất (UUID format)

401	Unauthorized Access token không hợp lệ hoặc đã hết hạn	—
400	Validation Error Dữ liệu đầu vào không hợp lệ (tên công ty trống, status không đúng, v.v.)	—
503	Service Unavailable Lỗi database	—

bash

RESPONSE 201 - Tạo thành công

{
  "code": 201,
  "message": "Đã tạo công ty (tổ chức) thành công.",
  "data": {
    "xid": "bede885e-4a78-4f6b-9a2d-36261cf37176",
    "full_name": "Le Chi Huy 2"
  }
}

codeinteger

Mã trạng thái HTTP. 201 nghĩa là tạo thành công.

messagestring

Thông báo kết quả.

dataobject

Thông tin công ty vừa tạo.

RESPONSE 401 - Lỗi xác thực

{
  "code": 401,
  "message": "Unauthenticated"
}

codeinteger

Mã lỗi HTTP.

messagestring

Thông báo lỗi chi tiết.

Ví dụ sử dụng

Tạo công ty mới với trạng thái Active

curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/company/create' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{
    "full_name": "Công ty TNHH ABC",
    "status": "Active"
  }'

Tạo công ty với trạng thái Pending (chưa sử dụng)

curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/company/create' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{
    "full_name": "Công ty TNHH XYZ",
    "status": "Pending"
  }'

Lưu ý quan trọng

Có thể lưu trữ company ID: Sau khi tạo, hãy lưu xid để sử dụng cho các API khác