본문으로 건너뛰기

회원(UserKey) 삭제하기

1. UserKey 삭제 API Flow​

2. 설명 (Description)​

  • 페이유에 가입된 회원의 key 값을 삭제(해지)할 목적으로 사용되는 API입니다.
  • UserKey 값을 삭제한 후에는 원복이 불가능합니다.

3. 요청 (Request)​

3.1. HTTP Request​

  • Method: POST
  • URL: https://payu-api.nicepay.co.kr/api/remove_userkey.do
  • Content-Type: application/x-www-form-urlencoded
  • Encoding: EUC-KR

3.2. 요청 파라미터​

필드명크기(byte)필수설명
MID10O가맹점 아이디
MallUserID20O가맹점 고객 아이디
UserKey70O삭제 대상 회원 Key
EdiDate14O요청 전문 생성 일시(YYYYMMDDHHMISS)
ReqType2O요청 타입 ('90' 고정)
Moid64O가맹점 주문번호 (고유한 값으로 설정, 나이스페이 가공 없음)
RemoveType2OUserKey 삭제 옵션 ('02' 고정)
SignData500O위변조 검증 데이터, 생성규칙: hex(sha256(MID + UserKey + EdiDate + ReqType + Moid + MerchantKey))
CharSet10인증 응답 인코딩 (euc-kr(default) / utf-8)

4. 응답 (Response)​

4.1. 응답 파라미터​

PG사의 기능 추가 및 서비스 개선에 따라 응답 필드는 사전 고지 없이 추가될 수 있습니다.
가맹점에서는 아래 표에 기재되지 않은 응답 필드가 추가될 수 있음을 고려하여 연동해야 하며, 추가 필드로 인해 파싱 오류 또는 결과 처리 오류가 발생하지 않도록 구현해야 합니다.

필드명크기(byte)설명
ResultCode4결과코드 (0000: 성공, 이외 실패)
ResultMsg100결과 메세지
TID30거래 아이디, 나이스페이에서 요청 트랜잭션을 처리한 고유한 식별값
MID10가맹점 아이디
UserKey30삭제 요청한 회원 Key (요청 Key값 그대로 전달)
ReqType2요청 타입 (90: UserKey 삭제)
Moid64가맹점 주문번호
Signature500위변조 검증 데이터, 생성규칙: hex(sha256(MID + UserKey + ReqType + Moid + MerchantKey))

5. 예시​

아래 예시는 테스트 시 이해를 돕기 위해 임의로 만든 데이터로 요청 및 응답 규격을 확인하기 위한 용도입니다.
예시 데이터를 실제 API 요청에 사용하지 않도록 주의해주세요.

5.1. 요청 예시​

POST /api/remove_userkey.do HTTP/1.1
Host: payu-api.nicepay.co.kr
Content-Type: application/x-www-form-urlencoded

MID=payutest0m&MallUserID=payuTEST&UserKey=PAYTKN816bdce64a149f2af7e90603a57446716af2b0a9f34e1427352c5405f2a6acf0&ReqType=90&Moid=TEST_123&CharSet=utf-8&EdiDate=20260814112056&RemoveType=02&SignData=18463c586d57c79e9ed86b94522467b7cdd5068431856879500e3469e59526c8

5.2. 응답 예시​

{
  "ReqType": "90",
  "Signature": "554546204e9a6800b39047f3f75087660bf8e72afb2cdcffbb35d0de94332c28",
  "UserKey": "PAYTKN816bdce64a149f2af7e90603a57446716af2b0a9f34e1427352c5405f2a6acf0",
  "ResultMsg": "정상 처리되었습니다.",
  "MID": "payutest0m",
  "Moid": "TEST_123",
  "ResultCode": "0000",
  "TID": "payutest0m00012608141121194137",
  "MallUserID": "payuTEST"
}