그룹 수정 | Bootpay 커머스 매뉴얼

고객 그룹의 정보를 변경해요. 회사명, 담당자 정보, 연락처 등을 수정할 수 있어요.

API 엔드포인트

PUThttps://api.bootapi.com/v1/user-groups/:user_group_idBasic Auth

business_number(사업자 등록번호)는 그룹 생성 후 변경할 수 없어요.

요청 파라미터

파라미터	타입	필수	설명
`user_group_id`	String	필수	그룹 고유 ID (URL 파라미터)
`company_name`	String	선택	회사명
`ceo_name`	String	선택	대표자명
`manager_name`	String	선택	담당자명
`phone`	String	선택	연락처
`email`	String	선택	이메일
`zipcode`	String	선택	우편번호
`address`	String	선택	주소
`address_detail`	String	선택	상세주소

코드 예제

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

const commerce = new BootpayCommerce({
    client_key: '{client_key}',
    secret_key: '{secret_key}'
});

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);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
user_group_id = '67e2052b03d0cb4e4117b0af'
response = commerce.user_group.update(user_group_id, {
    'user_group': {
        'company_name': '부트페이 주식회사 (수정)',
        'manager_name': '김담당',
        'phone': '02-9876-5432',
        'email': 'new@bootpay.co.kr'
    }
})
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$userGroupId = '67e2052b03d0cb4e4117b0af';
$response = $commerce->userGroup->update($userGroupId, [
    'user_group' => [
        'company_name' => '부트페이 주식회사 (수정)',
        'manager_name' => '김담당',
        'phone' => '02-9876-5432',
        'email' => 'new@bootpay.co.kr'
    ]
]);
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;
import kr.co.bootpay.store.model.pojo.SUserGroup;

TokenPayload tokenPayload = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore bootpay = new BootpayStore(tokenPayload);
SUserGroup userGroup = new SUserGroup();
userGroup.userGroupId = "67e2052b03d0cb4e4117b0af";
userGroup.companyName = "부트페이 주식회사 (수정)";
userGroup.managerName = "김담당";
userGroup.phone = "02-9876-5432";
userGroup.email = "new@bootpay.co.kr";

var response = bootpay.userGroup.update(userGroup);
System.out.println(response.getData());java

commerce = BootpayStore::Api.new('{client_key}', '{secret_key}')
user_group_id = '67e2052b03d0cb4e4117b0af'
response = commerce.user_group.update(user_group_id, {
    user_group: {
        company_name: '부트페이 주식회사 (수정)',
        manager_name: '김담당',
        phone: '02-9876-5432',
        email: 'new@bootpay.co.kr'
    }
})
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
userGroupId := "67e2052b03d0cb4e4117b0af"
response, err := commerce.UserGroup.Update(userGroupId, map[string]interface{}{
    "user_group": map[string]interface{}{
        "company_name": "부트페이 주식회사 (수정)",
        "manager_name": "김담당",
        "phone":        "02-9876-5432",
        "email":        "new@bootpay.co.kr",
    },
})
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var userGroupId = "67e2052b03d0cb4e4117b0af";
var response = await commerce.UserGroup.Update(userGroupId, new {
    user_group = new {
        company_name = "부트페이 주식회사 (수정)",
        manager_name = "김담당",
        phone = "02-9876-5432",
        email = "new@bootpay.co.kr"
    }
});
Console.WriteLine(response);csharp

응답

성공 응답

{
  "user_group_id": "67e2052b03d0cb4e4117b0af",
  "company_name": "부트페이 주식회사 (수정)",
  "business_number": "123-45-67890",
  "manager_name": "김담당",
  "phone": "02-9876-5432",
  "email": "new@bootpay.co.kr",
  "corporate_type": 2,
  "status": 1,
  "http_status": 200
}json

에러 코드

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

코드	메시지	대처 방법
`USER_GROUP_NOT_FOUND`	회원 그룹 정보를 찾지 못했어요. 다시 로그인해요.	user_group_id를 확인해요
`USER_GROUP_NOT_AUTHORIZED`	그룹 정보를 설정할 권한이 없어요.	그룹 관리자 권한이 있는지 확인해요