시작하기결제 매뉴얼커머스 매뉴얼

그룹 생성

기업 그룹(UserGroup)를 생성합니다. 같은 기업에 소속된 여러 사용자를 하나의 그룹으로 묶어, 구독 계약과 결제 내역을 통합 관리할 수 있습니다.

유의사항

  • 요청 시 business_number는 필수이며, 중복 여부를 확인합니다.
  • 중복된 사업자번호가 있으면 요청이 실패합니다.
POST
https://api.bootapi.com/v1/user-groups
1
SDK 설치
Server

서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
API 요청
Server

그룹 정보를 담아 POST 요청을 보냅니다.

user_group 필드
  • company_namestring필수회사명
  • business_numberstring필수사업자 등록번호 (10자리)
  • ceo_namestring대표자명
  • manager_namestring담당자명
  • phonestring연락처
  • emailstring이메일
  • zipcodestring우편번호
  • addressstring주소
  • address_detailstring상세주소
  • ex_uidstring외부 연동용 고유 ID
3
응답 처리
Server

성공 시 생성된 그룹 정보가 반환됩니다.

응답 필드
  • user_group_idstring생성된 그룹 고유 ID
  • company_namestring회사명
  • business_numberstring사업자 등록번호
  • corporate_typeinteger그룹 유형 (1: 개인, 2: 기업)
  • statusinteger상태 (1: 활성)
  • http_statusintegerHTTP 상태 코드

에러 코드

USER_GROUP_EXTERNAL_UID_EXIST
이미 존재하는 외부 UID입니다.
ex_uid 값을 확인하거나 다른 값을 사용하세요.
BUSINESS_NUMBER_DUPLICATE
이미 존재하는 사업자 등록번호입니다.
business_number를 확인하거나 기존 그룹을 조회하세요.
ACCESS_TOKEN_INVALID
유효하지 않은 액세스 토큰입니다.
토큰 발급 API를 통해 새로운 토큰을 발급받으세요.
언어
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
const { BootpayCommerce } = require('@bootpay/backend-js'); const commerce = new BootpayCommerce({    client_key: '{client_key}',    secret_key: '{secret_key}',    mode: 'development' // 또는 'production'}); const response = await commerce.userGroup.create({    user_group: {        company_name: '부트페이 주식회사',        business_number: '1234567890',        ceo_name: '홍길동',        manager_name: '김매니저',        phone: '02-1234-5678',        email: 'contact@bootpay.co.kr',        zipcode: '12345',        address: '서울특별시 강남구 역삼동',        address_detail: '부트페이빌딩 10층'    }});console.log(response);