change_phone_num (전화번호 변경)
전화번호 변경을 위한 이니시스 본인인증 파라미터를 생성합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/change_phone_num |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| phone |
string |
O |
변경할 새 전화번호 |
010-XXXX-XXXX |
요청 예시
{
"token": "eyJhbGci...",
"phone": "010-9876-5432"
}
응답
성공 (200)
{
"message": "전화번호 변경 본인인증 정보 생성 성공",
"mid": "이니시스_상점_ID",
"reqSvcCd": "01",
"mTxId": "REQ_abc1234567",
"successUrl": "https://asia-northeast3-construction24-test.cloudfunctions.net/change_phone_num_success",
"failUrl": "https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_fail",
"authHash": "sha256_hash_string",
"flgFixedUser": "Y",
"userName": "홍길동",
"userPhone": "01098765432",
"userBirth": "19900115",
"userHash": "sha256_user_hash_string"
}
실패
| 코드 |
message |
원인 |
| 401 |
"본인인증이 되지 않았습니다." |
본인인증 미완료 사용자 |
| 404 |
"존재하지 않는 유저입니다." |
사용자 DB에 없음 |
| 400 |
"필드 'phone'의 형식이 올바르지 않습니다." |
전화번호 형식 오류 |
| 500 |
"서버 오류 발생: {에러}" |
서버 오류 |
참고
- 본인인증이 완료된 사용자만 전화번호 변경이 가능합니다 (CI_hash 존재 필수).
- 반환된 정보를 이니시스 본인인증 SDK에 전달하여 새 전화번호로 인증을 진행합니다.
flgFixedUser가 Y로 설정되어 기존 이름/생년월일과 새 전화번호가 고정됩니다.- 인증 성공 시
change_phone_num_success에서 CI 비교 후 전화번호가 업데이트됩니다.
- 관련 API: [[get_inicis_info]], [[change_phone_num_success]]