인증 요청
post

본인인증이 가능한 URL을 생성합니다.

https://papi.udpay.co.kr/api/v1/uas/request
  • pApiToken

    STRING 필수

    연동토큰

    UDPAY 부가서비스 연동토큰

  • successUrl

    STRING 필수

    인증성공 URL

    인증 성공 시 리턴할 URL

  • failUrl

    STRING

    실패 URL

    인증 에러 및 취소시 리턴할 URL

  • feedBackUrl

    STRING

    피드백 URL

    인증 결과 피드백 URL

  • bgColor

    STRING

    화면 색상 설정

    허용값 리스트
    00 기본
    01 청록
    02 빨강
    03 보라
    04 남색
    05 초록
    06 올리브
    07 주황
    08 갈색
    09 회색
    10 진회색
  • isCharSet

    STRING

    Charset 설정

    허용값 리스트
    UTF-8
    EUC-KR
  • telecomType

    STRING

    통신사 설정

    허용값 리스트
    ALL 통신사 선택
    SKT SK Telecom
    KTF KT
    LGT LG U Plus
    MVNO 알뜰폰
  • age

    NUMBER

    나이 설정

    본인 인증 최소 나이제한 설정(만 나이)
    (age : 20 으로 설정 후 호출 시 인증하시는분 만 나이가 20살 이상일 경우 인증 불가 페이지로 이동합니다.)

  • viewType

    STRING

    호출 타입

    허용값 리스트
    WEB 웹 화면 모드
    MOBILE 모바일 화면 모드
  • returnValue1

    STRING

    리턴 값1

  • returnValue2

    STRING

    리턴 값2

  • returnValue3

    STRING

    리턴 값3

  • targetPhoneNumber

    STRING

    인증 전화번호

    전화번호 고정

  • state

    STRING 필수

    요청 결과

    true 성공, false 실패

  • message

    STRING

    메세지

    요청 결과 메세지

  • errorMessage

    STRING

    오류 메세지

    요청 결과에 대한 오류 메세지

  • errorType

    STRING

    오류 번호

    요청 결과에 대한 오류 번호

  • result

    STRING

    인증 URL

    본인인증 화면 URL

코드샘플
// https://mvnrepository.com/artifact/com.konghq/unirest-java/3.6.01

Map<String, Object> paramMap = new HashMap<> ();

paramMap.put ("successUrl", "");	// 인증성공 URL
paramMap.put ("failUrl", "");	// 실패 URL
paramMap.put ("feedBackUrl", "");	// 피드백 URL
paramMap.put ("bgColor", "00");	// 화면 색상 설정
paramMap.put ("isCharSet", "UTF-8");	// Charset 설정
paramMap.put ("telecomType", "ALL");	// 통신사 설정
paramMap.put ("age", "");	// 나이 설정
paramMap.put ("viewType", "WEB");	// 호출 타입
paramMap.put ("returnValue1", "");	// 리턴 값1
paramMap.put ("returnValue2", "");	// 리턴 값2
paramMap.put ("returnValue3", "");	// 리턴 값3
paramMap.put ("targetPhoneNumber", "");	// 인증  전화번호

HttpResponse response = Unirest.post("https://papi.udpay.co.kr/api/v1/uas/request")
.header("accept", "application/json")
.header("Content-Type", "application/json")
.header("pApiToken", "") // 연동토큰
.body(paramMap)
.asJson();

// JSONObject obj = response.getBody().getObject().getJSONObject("objKey");
// String strVal = obj.getString ("strKey");
// JSONArray arr = response.getBody().getObject().getJsonArray("arrayKey");
본인인증 결과
feedback

본인인증을 결과 정보입니다.

  • Feedback 인증 성공 URL 인증 성공시 로 리턴되는 데이터
    • cmd

      STRING 필수

      피드백 타입

      허용값 리스트
      UAS 본인인증
    • state

      STRING 필수

      상태

      허용값 리스트
      SUCCESS 성공
    • code

      STRING 필수

      상태 코드

      허용값 리스트
      0000 성공
    • message

      STRING

      메세지

    • name

      STRING

      이름

    • birthday

      STRING

      생년월일

      YYYYMMDD
      예시 : 19860318

    • sex

      STRING

      성별

      허용값 리스트
      1 남성
      2 여성
    • phone

      STRING

      휴대폰 번호

    • carrier

      STRING

      통신사

      허용값 리스트
      SKT
      KTF
      LGT
      MVNO
    • returnValue1

      STRING

      리턴 값1

    • returnValue2

      STRING

      리턴 값2

    • returnValue3

      STRING

      리턴 값3

  • Feedback 실패 URL 인증 실패시 리턴되는 데이터
    • cmd

      STRING

      피드백 타입

      허용값 리스트
      UAS 본인인증
    • state

      STRING

      상태

      허용값 리스트
      FAIL 인증 실패
    • code

      STRING

      상태 코드

      허용값 리스트
      9992 인증 절차를 모두 거치지 않아 자동 취소되었습니다. 다시 시도해 주십시오.
      9995 시간 지연으로 거래가 자동 취소되었습니다. 다시 시도해주십시오.
    • message

      STRING

      메세지

    • returnValue1

      STRING

      리턴 값1

    • returnValue2

      STRING

      리턴 값2

    • returnValue3

      STRING

      리턴 값3

  • Feedback 피드백 URL 설정한 피드백 URL로 데이터를 전송합니다.
    • cmd

      STRING

      피드백 타입

      허용값 리스트
      UAS 본인인증
    • state

      STRING

      상태

      허용값 리스트
      SUCCESS 성공
      FAIL 실패
    • code

      STRING

      상태 코드

      허용값 리스트
      0000 성공
      9992 인증 절차를 모두 거치지 않아 자동 취소되었습니다. 다시 시도해 주십시오.
      9995 시간 지연으로 거래가 자동 취소되었습니다. 다시 시도해주십시오.
    • message

      STRING

      메세지

    • name

      STRING

      이름

    • birthday

      STRING

      생년월일

      YYYYMMDD
      예시 : 19860318

    • sex

      STRING

      성별

      허용값 리스트
      1 남성
      2 여성
    • phone

      STRING

      휴대폰 번호

    • carrier

      STRING

      통신사

      허용값 리스트
      SKT
      KTF
      LGT
      MVNO
    • returnValue1

      STRING

      리턴 값1

    • returnValue2

      STRING

      리턴 값2

    • returnValue3

      STRING

      리턴 값3