고객 수정 | Bootpay 커머스 매뉴얼

등록된 고객 정보를 수정해요.

API 엔드포인트

PUThttps://api.bootapi.com/v1/users/:user_idBasic Auth

요청 파라미터

파라미터	타입	필수	설명
`user_id`	String	필수	고객 ID 또는 external_uid (URL 경로)
`name`	String	선택	고객 이름
`phone`	String	선택	휴대폰 번호
`email`	String	선택	이메일 주소
`tel`	String	선택	유선 전화번호
`nickname`	String	선택	별명
`gender`	Integer	선택	성별 (0: 여자, 1: 남자)
`birth`	String	선택	생년월일 6자리
`login_id`	String	선택	로그인 아이디
`login_pw`	String	선택	로그인 비밀번호
`comment`	String	선택	추가 정보/메모

코드 예제

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.update('67e4b4425ec892162491d0ec', {
    name: '홍길동',
    phone: '01098765432',
    email: 'new-email@example.com'
})
console.log(response)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.update(
    '67e4b4425ec892162491d0ec',
    name='홍길동',
    phone='01098765432',
    email='new-email@example.com'
)
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
$response = $commerce->userUpdate('67e4b4425ec892162491d0ec', [
    'name' => '홍길동',
    'phone' => '01098765432',
    'email' => 'new-email@example.com'
]);
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("name", "홍길동");
params.put("phone", "01098765432");
params.put("email", "new-email@example.com");

HashMap<String, Object> response = commerce.userUpdate("67e4b4425ec892162491d0ec", params);
System.out.println(response);java

commerce = BootpayStore::Api.new('your-commerce-client-key', 'your-commerce-secret-key')
response = commerce.user_update(
  '67e4b4425ec892162491d0ec',
  name: '홍길동',
  phone: '01098765432',
  email: 'new-email@example.com'
)
puts responseruby

commerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.UserUpdate("67e4b4425ec892162491d0ec", map[string]interface{}{
    "name":  "홍길동",
    "phone": "01098765432",
    "email": "new-email@example.com",
})
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.UserUpdate("67e4b4425ec892162491d0ec", new {
    name = "홍길동",
    phone = "01098765432",
    email = "new-email@example.com"
});
Console.WriteLine(response);csharp

응답

성공 응답

{
  "user_id": "67e4b4425ec892162491d0ec",
  "name": "홍길동",
  "email": "new-email@example.com",
  "phone": "01098765432",
  "updated_at": "2025-07-11T14:00:00Z"
}json

에러 응답

{
  "status": 404,
  "code": 2300,
  "message": "고객을 찾을 수 없습니다.",
  "data": null
}json

에러 코드

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

코드	메시지	대처 방법
`USER_NOT_FOUND`	회원정보가 없어요. 다시 확인해요.	user_id를 확인해요
`USER_EMAIL_EXIST`	이미 사용중인 이메일이에요	다른 이메일을 사용해요
`USER_EMAIL_INVALID`	이메일이 입력되지 않았거나 이메일 형식에 맞지 않는다 다시 입력해요	올바른 이메일 형식으로 입력해요

수정하지 않는 필드는 요청에 포함하지 않아도 돼요. 포함된 필드만 업데이트돼요.