본문으로 건너뛰기

마이페이지 화면 호출하기

1. 마이페이지 화면 Flow​

2. 설명 (Description)​

  • 고객의 결제 수단 정보 조회 및 삭제, 비밀번호(PIN) 변경 요청 시 PG에서 제공하는 화면을 통해 원하는 작업을 진행하는 서비스입니다.
  • 고객께서 마이페이지 화면을 통해 원하는 작업을 처리하면, 가맹점은 정상 응답코드를 받은 후 고객에게 정상 처리 여부 화면 출력 등 다음 프로세스를 진행합니다.

3. 요청 (Request)​

3.1. HTTP Request​

  • Method: POST
  • URL: https://payu.nicepay.co.kr/main.do
  • Content-Type: application/x-www-form-urlencoded
  • Encoding: EUC-KR
PC/Mobile 화면 호출 관련 참고 사항
  • PC 환경: POPUP(420*670) 생성 후 form data submit
  • 모바일 환경: form data submit

3.2. 요청 파라미터​

필드명크기(byte)필수설명
MID10O가맹점 아이디
MallUserID20O거래 아이디
UserKey70O회원 등록 시 발급된 사용자 Key
EdiDate14O요청 전문 생성 일시(YYYYMMDDHHMISS)
PageType10O요청 페이지 구분 ("MyPage" 고정)
ReturnUrl200O마이페이지 화면 호출 후 결과를 수신받을 가맹점 측 URL
SignData256O위변조 검증 데이터, 생성규칙: hex(sha256(EdiDate + MID + UserKey + MerchantKey))
CharSet10인증 응답 인코딩 (euc-kr(default) / utf-8)

4. 응답 (Response)​

4.1. 응답 파라미터​

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

필드명크기(byte)설명
AuthResultCode4결과코드 (0000: 성공, 이외 실패)
AuthResultMsg100결과 메세지
AuthToken40인증 토큰, 마이페이지 호출에 대한 고유 key 값

5. 예시​

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

5.1. 요청 예시​


<form method="post" action="https://payu.nicepay.co.kr/main.do">
  <!-- 필수 파라미터 -->
  <input type="hidden" name="MID" value="nictest00m" />
  <input type="hidden" name="MallUserID" value="payuTEST" />
  <input type="hidden" name="UserKey" value="PAYTKN816bdce64a149f2af7e90603a57446716af2b0a9f34e1427352c5405f2a6acf0" />
  <input type="hidden" name="EdiDate" value="20260814110304" />
  <input type="hidden" name="PageType" value="MyPage" />
  <input type="hidden" name="ReturnUrl" value="http://localhost:8080/payhome" />
  <input type="hidden" name="SignData" value="8fdd91df38f1982737bd09514668573e2c53a4a2229db88cf3b5ef91b2bdb454" />
  
  <!-- 추가 파라미터 -->
  <input type="hidden" name="CharSet" value="" />

  <!-- 요청 버튼 -->
  <button type="submit">결제하기</button>
</form>

5.2. 응답 예시​

{
  "AuthResultCode":"0000",
  "AuthResultMsg":"정상처리 되었습니다.",
  "AuthToken":"PAYTOKEN8249A5BF57E5D13C3111F66223E0A1E5"
}