---
title: "본인인증 요청 API"
method: POST
path: "/certifications/otp/request"
tags: ["certifications"]
---

# 본인인증 요청 API

`POST /certifications/otp/request`

사용자 개인정보를 API로 전달하여, 통신사로부터 확인되는 경우 OTP(6자리 인증번호)를 사용자에게 SMS로 전달합니다.
<br><br>통신사 승인을 받은 일부 고객사에 한해 사용하실 수 있으며, 현재 <b>다날</b>, <b>kcp(신모듈)</b>을 통해서만 서비스되고 있습니다.
<br><br>본인인증 대상자의 성명, 생년월일 + 주민등록 뒷부분 첫 자리, 휴대폰번호, 통신사 정보를 고객사에서 직접 입력받아 API요청하면 됩니다. 전달된 개인정보가 올바를 경우 해당 휴대폰으로 인증번호 SMS가 전송됩니다.
<br><br>200응답 시 imp_uid 가 응답데이터로 전달되며, SMS전송된 인증번호를 본인인증 완료 API 로 요청주시면 최종 본인인증 프로세스가 완료됩니다.

## Response `200`

본인인증을 위한 대상자 정보 검증 완료(인증번호 SMS전송요청 중)

- CertificationOTPResponse — 본인인증 결과 객체. 바로 아래 Certification structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` CertificationOTPAnnotation
    - `imp_uid` string, required — 포트원 인증 고유번호

## Other responses

- `400` — 대상자 개인정보 중 일부가 누락되었거나 올바르지 않은 경우
- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `500` — 처리 중 다날서버 응답오류 등 오류가 발생한 경우

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/revisions/006dfffdec43/schema)