마켓플레이스

그룹 생성

거래처 단위를 그룹으로 묶어 조직별 구매 흐름을 열어요.

기업 고객 그룹을 생성해요. 동일 기업 소속 사용자를 하나의 그룹으로 통합 관리할 수 있어요.

API 엔드포인트

POSThttps://api.bootapi.com/v1/user-groupsBasic Auth

그룹 유형

유형 설명
기업 그룹 (corporate_type: 2) 동일 기업 소속 사용자를 통합 관리. 기업 구독·결제 일괄 처리
개인 그룹 (corporate_type: 1) 회원 가입 시 자동 생성되는 개인 전용 그룹

요청 파라미터

파라미터 타입 필수 설명
company_name String 필수 회사명
business_number String 필수 사업자등록번호 (10자리)
ceo_name String 선택 대표자명
manager_name String 선택 담당자명
phone String 선택 전화번호
email String 선택 이메일
zipcode String 선택 우편번호
address String 선택 주소
address_detail String 선택 상세주소
ex_uid String 선택 외부 고유 ID

코드 예제

const { BootpayCommerce } = require('@bootpay/backend-js')

const commerce = new BootpayCommerce({
    client_key: 'your-commerce-client-key',
    secret_key: 'your-commerce-secret-key',
    mode: 'production'
})

const response = await commerce.userGroup.create({
    company_name: '(주)부트페이',
    business_number: '1234567890',
    ceo_name: '홍길동',
    manager_name: '김철수',
    phone: '0212345678',
    email: 'company@example.com'
})
console.log('user_group_id:', response.user_group_id)javascript

응답

성공 응답

{
  "user_group_id": "grp_687a1b2c3d4e5f",
  "company_name": "(주)부트페이",
  "business_number": "1234567890",
  "corporate_type": 2,
  "status": 1
}json

에러 응답

{
  "status": 400,
  "code": 434,
  "message": "이미 존재하는 사업자 등록번호입니다.",
  "data": null
}json

에러 코드

공통 에러

인증·권한 관련 에러는 에러 코드표를 참고해요.

코드 메시지 대처 방법
USER_GROUP_ALREADY_EXISTS 이미 존재하는 그룹이에요 기존 그룹을 확인해요
USER_GROUP_EXTERNAL_UID_EXIST 중복된 사업자 UNIQ ID예요. 다른 ex_uid를 사용해요
USER_GROUP_BUSINESS_NUMBER_ALREADY_EXISTS 중복된 사업자번호를 가진 그룹이 이미 있어요. 기존 그룹을 확인해요
USER_COMPANY_NAME_BLANK 기업회원은 회사을 입력해야 해요. company_name을 입력해요
USER_BUSINESS_NUMBER_BLANK 기업회원은 사업자 등록번호를 입력해야 해요. business_number를 입력해요

user_group_id를 고객 등록 시 user_group_id 파라미터에 전달하면 해당 고객을 기업 그룹에 소속시킬 수 있어요.