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

그룹 정보 변경

그룹(UserGroup)정보를 변경합니다.

권한 안내

  • 기업 그룹의 경우 business_number는 변경할 수 없습니다.
  • 개인 그룹의 경우 user 권한으로도 변경할 수 있습니다.
PUT
https://api.bootapi.com/v1/user-groups/:user_group_id
1
SDK 설치
Server

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

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

변경할 그룹 정보를 담아 PUT 요청을 보냅니다.

user_group 필드
  • company_namestring회사명
  • ceo_namestring대표자명
  • manager_namestring담당자명
  • phonestring연락처
  • emailstring이메일
  • zipcodestring우편번호
  • addressstring주소
  • address_detailstring상세주소
3
응답 처리
Server

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

응답 필드
  • user_group_idstring그룹 고유 ID
  • company_namestring회사명
  • business_numberstring사업자 등록번호
  • manager_namestring담당자명
  • phonestring연락처
  • emailstring이메일
  • corporate_typeinteger그룹 유형 (1: 개인, 2: 기업)
  • statusinteger상태 (1: 활성)
  • http_statusintegerHTTP 상태 코드

에러 코드

USER_GROUP_NOT_FOUND
그룹을 찾을 수 없습니다.
user_group_id를 확인하거나 그룹 목록에서 조회하세요.
USER_GROUP_NOT_AUTHORIZED
그룹에 대한 접근 권한이 없습니다.
토큰의 권한을 확인하거나 admin 권한으로 재시도하세요.
ACCESS_TOKEN_INVALID
유효하지 않은 액세스 토큰입니다.
토큰 발급 API를 통해 새로운 토큰을 발급받으세요.
언어
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
const { BootpayCommerce } = require('@bootpay/backend-js'); const commerce = new BootpayCommerce({    client_key: '{client_key}',    secret_key: '{secret_key}',    mode: 'development' // 또는 'production'}); const userGroupId = '67e2052b03d0cb4e4117b0af';const response = await commerce.userGroup.update(userGroupId, {    user_group: {        company_name: '부트페이 주식회사 (수정)',        manager_name: '김담당',        phone: '02-9876-5432',        email: 'new@bootpay.co.kr'    }});console.log(response);