기업 고객 그룹을 생성해요. 동일 기업 소속 사용자를 하나의 그룹으로 통합 관리할 수 있어요.
API 엔드포인트
POST
https://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)javascriptfrom bootpay_backend import BootpayCommerce
commerce = BootpayCommerce(
client_key='your-commerce-client-key',
secret_key='your-commerce-secret-key',
mode='production'
)
response = commerce.user_group.create(
company_name='(주)부트페이',
business_number='1234567890',
ceo_name='홍길동',
manager_name='김철수',
phone='0212345678',
email='company@example.com'
)
print('user_group_id:', response['user_group_id'])pythonuse Bootpay\ServerPhp\BootpayCommerceApi;
$commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
$response = $commerce->userGroupCreate([
'company_name' => '(주)부트페이',
'business_number' => '1234567890',
'ceo_name' => '홍길동',
'manager_name' => '김철수',
'phone' => '0212345678',
'email' => 'company@example.com'
]);
print_r($response);phpimport kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;
import java.util.HashMap;
TokenPayload tp = new TokenPayload("your-commerce-client-key", "your-commerce-secret-key");
BootpayStore commerce = new BootpayStore(tp);
HashMap<String, Object> params = new HashMap<>();
params.put("company_name", "(주)부트페이");
params.put("business_number", "1234567890");
params.put("ceo_name", "홍길동");
params.put("manager_name", "김철수");
params.put("phone", "0212345678");
params.put("email", "company@example.com");
HashMap<String, Object> response = commerce.userGroupCreate(params);
System.out.println(response);javacommerce = BootpayStore::Api.new('your-commerce-client-key', 'your-commerce-secret-key')
response = commerce.user_group_create(
company_name: '(주)부트페이',
business_number: '1234567890',
ceo_name: '홍길동',
manager_name: '김철수',
phone: '0212345678',
email: 'company@example.com'
)
puts responserubycommerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.UserGroupCreate(map[string]interface{}{
"company_name": "(주)부트페이",
"business_number": "1234567890",
"ceo_name": "홍길동",
"manager_name": "김철수",
"phone": "0212345678",
"email": "company@example.com",
})
fmt.Println(response)gousing Bootpay.Commerce;
var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.UserGroupCreate(new {
company_name = "(주)부트페이",
business_number = "1234567890",
ceo_name = "홍길동",
manager_name = "김철수",
phone = "0212345678",
email = "company@example.com"
});
Console.WriteLine(response);csharp응답
성공 응답
{
"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 파라미터에 전달하면 해당 고객을 기업 그룹에 소속시킬 수 있어요.
