회원 제거 | Bootpay 커머스 매뉴얼

기업 그룹(UserGroup)에 등록된 회원(User)을 제거해요. 제거된 회원이 주문할 경우 기업 그룹 내에서는 조회되지 않아요.

API 엔드포인트

DELETEhttps://api.bootapi.com/v1/user-groups/:user_group_id/remove_userBasic Auth

제거된 회원의 이전 주문 내역은 그대로 남아있어요.
제거된 회원은 다시 그룹에 추가할 수 있어요.

요청 파라미터

파라미터	타입	필수	설명
`user_group_id`	String	필수	그룹 고유 ID (URL 파라미터)
`user_id`	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.removeUser(userGroupId, {
    user_id: '67e2052b03d0cb4e4117b0b1'
});
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
user_group_id = '67e2052b03d0cb4e4117b0af'
response = commerce.user_group.remove_user(user_group_id, {
    'user_id': '67e2052b03d0cb4e4117b0b1'
})
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

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

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

TokenPayload tokenPayload = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore bootpay = new BootpayStore(tokenPayload);
UserGroupRemoveUserParams params = new UserGroupRemoveUserParams();
params.userGroupId = "67e2052b03d0cb4e4117b0af";
params.userId = "67e2052b03d0cb4e4117b0b1";

var response = bootpay.asManager().userGroup.removeUser(params);
System.out.println(response.getData());java

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

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
userGroupId := "67e2052b03d0cb4e4117b0af"
response, err := commerce.UserGroup.RemoveUser(userGroupId, map[string]interface{}{
    "user_id": "67e2052b03d0cb4e4117b0b1",
})
fmt.Println(response)go

using Bootpay.Commerce;

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

응답

성공 응답

{
  "http_status": 200
}json

에러 코드

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

코드	메시지	대처 방법
`USER_NOT_FOUND`	회원정보가 없어요. 다시 확인해요.	user_id를 확인해요
`USER_GROUP_NOT_FOUND`	회원 그룹 정보를 찾지 못했어요. 다시 로그인해요.	user_group_id를 확인해요
`USER_NOT_IN_GROUP`	사용자가 그룹에 속해 있지 않아요.	사용자의 그룹 소속을 확인해요
`USER_GROUP_WITHDRAW_FAILED`	사용자 그룹 추방에 실패했어요.	요청 파라미터를 확인 후 재시도해요