고객 등록 | Bootpay 커머스 매뉴얼

쇼핑몰 고객(회원) 정보를 Bootpay에 등록해요.

고객 정보를 등록하는 API예요. 이전 시스템의 고객 데이터 이전, 오프라인/제휴 고객 등록에 사용해요.

API 엔드포인트

POSThttps://api.bootapi.com/v1/users/joinBasic Auth

고객 유형

유형	설명
회원	쇼핑몰에 직접 가입하여 로그인 계정을 보유한 고객
비회원	판매자가 주문 링크 발송을 위해 등록한 고객

그룹 유형

유형	설명
기업 그룹	동일 기업 소속 사용자를 통합 관리
개인 그룹	회원 가입 시 자동 생성되는 개인 전용 그룹

요청 파라미터

파라미터	타입	필수	설명
`login_id`	String	필수	로그인 아이디 (영문/숫자, 5~30자)
`login_pw`	String	필수	로그인 비밀번호
`name`	String	필수	고객 이름
`email`	String	선택	이메일 주소 (설정에 따라 필수)
`phone`	String	선택	휴대폰 번호 (설정에 따라 필수)
`external_uid`	String	선택	외부 고유 ID (가맹점 식별자)
`tel`	String	선택	유선 전화번호
`birth`	String	선택	생년월일 6자리
`gender`	Integer	선택	성별 (0: 여자, 1: 남자)
`nickname`	String	선택	별명
`comment`	String	선택	추가 정보/메모
`user_group_id`	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.user.create({
    login_id: 'user001',
    login_pw: 'securePassword123',
    name: '홍길동',
    email: 'user@example.com',
    phone: '01012345678',
    external_uid: 'EXT_USER_001'
})
console.log('user_id:', response.user_id)javascript

from bootpay_backend import BootpayCommerce

commerce = BootpayCommerce(
    client_key='your-commerce-client-key',
    secret_key='your-commerce-secret-key',
    mode='production'
)

response = commerce.user.create(
    login_id='user001',
    login_pw='securePassword123',
    name='홍길동',
    email='user@example.com',
    phone='01012345678',
    external_uid='EXT_USER_001'
)
print('user_id:', response['user_id'])python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
$response = $commerce->userCreate([
    'login_id' => 'user001',
    'login_pw' => 'securePassword123',
    'name' => '홍길동',
    'email' => 'user@example.com',
    'phone' => '01012345678',
    'external_uid' => 'EXT_USER_001'
]);
print_r($response);php

import 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("login_id", "user001");
params.put("login_pw", "securePassword123");
params.put("name", "홍길동");
params.put("email", "user@example.com");
params.put("phone", "01012345678");
params.put("external_uid", "EXT_USER_001");

HashMap<String, Object> response = commerce.userCreate(params);
System.out.println(response);java

commerce = BootpayStore::Api.new('your-commerce-client-key', 'your-commerce-secret-key')
response = commerce.user_create(
  login_id: 'user001',
  login_pw: 'securePassword123',
  name: '홍길동',
  email: 'user@example.com',
  phone: '01012345678',
  external_uid: 'EXT_USER_001'
)
puts responseruby

commerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.UserCreate(map[string]interface{}{
    "login_id":     "user001",
    "login_pw":     "securePassword123",
    "name":         "홍길동",
    "email":        "user@example.com",
    "phone":        "01012345678",
    "external_uid": "EXT_USER_001",
})
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.UserCreate(new {
    login_id = "user001",
    login_pw = "securePassword123",
    name = "홍길동",
    email = "user@example.com",
    phone = "01012345678",
    external_uid = "EXT_USER_001"
});
Console.WriteLine(response);csharp

응답

성공 응답

{
  "user_id": "67e4b4425ec892162491d0ec",
  "external_uid": "EXT_USER_001",
  "login_id": "user001",
  "membership_type": 1,
  "status": 1
}json

에러 응답

{
  "status": 400,
  "code": 400,
  "message": "이미 존재하는 로그인 아이디입니다.",
  "data": null
}json

에러 코드

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

코드	메시지	대처 방법
`USER_NAME_BLANK`	고객명은 필수예요. 고객명을 입력해요.	name을 입력해요
`USER_ID_EXIST`	이미 사용중인 아이디예요	다른 login_id를 사용해요
`USER_EMAIL_EXIST`	이미 사용중인 이메일이에요	다른 이메일을 사용해요
`USER_ID_BLANK`	로그인 할 아이디를 입력해요	login_id를 입력해요
`USER_ID_INVALID`	로그인 할 아이디는 영문 + 숫자로만 사용이 가능하고 5자 이상 30자 이내로 입력해요	형식에 맞는 login_id를 입력해요
`USER_EMAIL_INVALID`	이메일이 입력되지 않았거나 이메일 형식에 맞지 않는다 다시 입력해요	올바른 이메일 형식으로 입력해요

user_id 또는 external_uid로 주문서 생성 시 고객을 지정할 수 있고, 로그인 토큰을 발급받을 수도 있어요.