콘텐츠로 이동

inicis_find_email (이메일 찾기 - 본인인증 요청)

비로그인 사용자가 이메일(아이디)을 찾기 위해 이니시스 본인인증 요청 정보를 생성합니다.

기본 정보

항목
URL https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_find_email
Method POST
인증 불필요

요청

Body

필드 타입 필수 설명 검증
name string O 사용자 이름 -
birth string O 생년월일 YYYY-MM-DD
sex string O 성별 male, female
phone string O 전화번호 010-XXXX-XXXX

요청 예시

{
  "name": "홍길동",
  "birth": "1990-01-15",
  "sex": "male",
  "phone": "010-1234-5678"
}

응답

성공 (200)

{
  "message": "본인인증 정보 생성 성공",
  "data": {
    "mid": "이니시스_상점_ID",
    "reqSvcCd": "01",
    "mTxId": "REQ_abc1234567",
    "successUrl": "https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_find_email_success",
    "failUrl": "https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_fail",
    "authHash": "sha256_hash_string",
    "flgFixedUser": "Y",
    "userName": "홍길동",
    "userPhone": "01012345678",
    "userBirth": "19900115",
    "userHash": "sha256_user_hash_string"
  }
}

응답 필드 설명

필드 타입 설명
mid string 이니시스 상점 ID
reqSvcCd string 서비스 코드 (01: 휴대폰 본인인증)
mTxId string 고유 거래번호
successUrl string 인증 성공 리다이렉트 URL
failUrl string 인증 실패 리다이렉트 URL
authHash string 보안 해시
flgFixedUser string 사용자 정보 고정 여부 ("Y")
userName string 사용자 이름
userPhone string 전화번호 (숫자만)
userBirth string 생년월일 (YYYYMMDD)
userHash string 사용자 정보 해시

실패

코드 message 원인
400 필드 검증 에러 필수 필드 누락 또는 형식 오류
500 "오류 발생: {에러 내용}" 서버 내부 오류

참고

  • 반환된 정보를 이니시스 본인인증 SDK에 전달하여 인증을 진행합니다.
  • 인증 성공 시 inicis_find_email_success로 리다이렉트되어 이메일을 확인할 수 있습니다.
  • 입력한 이름, 전화번호, 생년월일이 DB에 일치하는 사용자가 없어도 본인인증 정보는 생성됩니다. (인증 성공 후 사용자 조회 시 실패 처리)
  • 관련 API: [[inicis_find_email_success]], [[send_password_reset_email]]