그룹 상세 | Bootpay 커머스 매뉴얼

특정 고객 그룹의 상세 정보를 조회해요. 회사명, 사업자 등록번호, 담당자 정보, 그룹 유형 등 모든 정보를 확인할 수 있어요.

API 엔드포인트

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

요청 파라미터

파라미터	타입	필수	설명
`user_group_id`	String	필수	조회할 그룹의 고유 ID (URL 파라미터)

코드 예제

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.detail(userGroupId);
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
user_group_id = '67e2052b03d0cb4e4117b0af'
response = commerce.user_group.detail(user_group_id)
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$userGroupId = '67e2052b03d0cb4e4117b0af';
$response = $commerce->userGroup->detail($userGroupId);
print_r($response);php

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

TokenPayload tokenPayload = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore bootpay = new BootpayStore(tokenPayload);
String userGroupId = "67e2052b03d0cb4e4117b0af";
var response = bootpay.userGroup.detail(userGroupId);
System.out.println(response.getData());java

commerce = BootpayStore::Api.new('{client_key}', '{secret_key}')
user_group_id = '67e2052b03d0cb4e4117b0af'
response = commerce.user_group.detail(user_group_id)
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
userGroupId := "67e2052b03d0cb4e4117b0af"
response, err := commerce.UserGroup.Detail(userGroupId)
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var userGroupId = "67e2052b03d0cb4e4117b0af";
var response = await commerce.UserGroup.Detail(userGroupId);
Console.WriteLine(response);csharp

응답

성공 응답

{
  "user_group_id": "67e2052b03d0cb4e4117b0af",
  "company_name": "부트페이 주식회사",
  "business_number": "123-45-67890",
  "corporate_type": 2,
  "manager_name": "홍길동",
  "phone": "02-1234-5678",
  "email": "contact@bootpay.co.kr",
  "status": 1,
  "http_status": 200
}json

그룹 유형

값	유형	설명
`PROCESS_DUPLICATED`	이미 처리된 요청이에요	개인 고객 그룹
2	기업	기업 고객 그룹

에러 코드

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

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