회원 등록 | Bootpay 커머스 매뉴얼

기업 그룹(UserGroup)에 회원을 등록해요. 같은 기업에 여러 회원을 등록하여 주문과 구독 내역을 관리할 수 있어요.

API 엔드포인트

POSThttps://api.bootapi.com/v1/user-groups/:user_group_id/add_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.addUser(userGroupId, {
    user_id: '67e0f47d03d0cb4e4117b083'
});
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

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

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$userGroupId = '67e2052b03d0cb4e4117b0af';
$response = $commerce->userGroup->addUser($userGroupId, [
    'user_id' => '67e0f47d03d0cb4e4117b083'
]);
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";
String userId = "67e0f47d03d0cb4e4117b083";

var response = bootpay.asManager().userGroup.addUser(userGroupId, userId);
System.out.println(response.getData());java

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

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

using Bootpay.Commerce;

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

응답

성공 응답

{
  "http_status": 200
}json

에러 코드

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

코드	메시지	대처 방법
`USER_NOT_FOUND`	회원정보가 없어요. 다시 확인해요.	user_id를 확인해요
`USER_GROUP_NOT_FOUND`	회원 그룹 정보를 찾지 못했어요. 다시 로그인해요.	user_group_id를 확인해요
`USER_ALREADY_IN_GROUP`	사용자가 이미 그룹에 속해있어요.	그룹 멤버 목록을 확인해요
`USER_GROUP_ENROLL_FAILED`	사용자 그룹 등록에 실패했어요.	요청 파라미터를 확인 후 재시도해요