Company Creation API

API to create a new company in the Bank Hub system. Allows creating a company with a name and an initial status.

POST

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

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request Body

Name	Type	Required	Description
`full_name`	string	Required	Company full name. Maximum 200 characters.
`status`	string	Required	Initial company status. Values: `Active` or `Pending`.

Headers

Name	Type	Required	Description
`Authorization`	Bearer Token	Required	Access token obtained from the /v1/token API
`Content-Type`	string	Required	application/json

Note

This API requires a Bearer Token in the Authorization header
The company name must be unique within the merchant scope
The status should be set to Active at creation time so the company can be used immediately
After creation, the company will receive a unique xid (UUID format)

401	Unauthorized The access token is invalid or has expired	—
400	Validation Error Invalid input data (empty company name, invalid status, etc.)	—
503	Service Unavailable Database error	—

bash

RESPONSE 201 - Created Successfully

{
  "code": 201,
  "message": "Company (organization) created successfully.",
  "data": {
    "xid": "bede885e-4a78-4f6b-9a2d-36261cf37176",
    "full_name": "Le Chi Huy 2"
  }
}

codeinteger

HTTP status code. 201 indicates the creation was successful.

messagestring

Result message.

dataobject

Information of the newly created company.

RESPONSE 401 - Authentication Error

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

codeinteger

HTTP error code.

messagestring

Detailed error message.

Usage Examples

Important Notes

You can store the company ID: After creation, save the xid to use with other APIs