API

사업자 정보 등록

작성일 2026.03.14 | 수정일 2026.03.14

POST/cash/v1/company

새로운 사업자 정보를 등록합니다. 이미 등록된 사업자 정보가 있는 경우 사용할 수 없습니다.

Body Params

NameTypeRequiredDescription
namestring*법인명 (단체명). 최대 64자.
ownerstring*대표자명. 최대 60자.
addressstring*사업장 주소. 최대 128자.
businessNumberstring*사업자등록번호. 최대 24자.
businessTypestring*업태. 최대 64자.
businessItemsstring*종목. 최대 128자.
contactsarray*담당자 목록 (최소 1명, 최대 5명)
namestring*담당자 이름 (최대 20자)
emailstring*담당자 이메일 (최대 128자)
phonestring담당자 연락처 (최대 20자)

Response

NameTypeRequiredDescription
companyIdstring*생성된 사업자 정보 고유 ID

Structure

Request
{ "name": "(주)테스트", "owner": "홍길동", "address": "서울시 강남구 테헤란로 123", "businessNumber": "123-45-67890", "businessType": "정보통신업", "businessItems": "소프트웨어 개발", "contacts": [ { "name": "김담당", "email": "manager@example.com", "phone": "010-1234-5678" } ] }
Response
{ "companyId": { "type": "string", "always": true, "description": "생성된 사업자 정보 고유 ID" } }