⌨️본인인증 결과조회 API
본인인증 결과를 조회합니다.
본인인증된 결과를 조회할 때 사용합니다.
본인인증 결과를 imp_uid를 이용하여 조회합니다.
GET
https://api.iamport.kr/certifications/{imp_uid}
Request Body
Name | Type | Description |
---|---|---|
imp_uid* | String | 포트원 인증고유번호 |
code
integer
응답코드
0이면 정상적인 조회, 0 이 아닌 값이면 message를 확인해봐야 합니다
message
string
응답메세지
code 값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
response (CertificationAnnotation, optional)
imp_uid
* string
인증고유번호
merchant_uid
string
주문번호
pg_tid
string
PG사 인증결과 고유번호
pg_provider
* string
본인인증 제공 PG사 명칭
name
string
실명
gender
string
성별
male:남성
female:여성
birthday
string
생년월일
ISO8601 형식의 문자열. YYYY-MM-DD 10자리 문자열
foreigner
boolean
외국인여부
다날 본인인증서비스 계약시 외국인 구분기능 추가 요청을 해주셔야 사용이 가능합니다
true : 외국인
false : 내국인
phone
string
휴대폰번호
특수기호없이 숫자로만 구성된 휴대폰번호가 전달. 통신사 사전승인이 이뤄지지 않으면 phone 속성은 존재하지 않습니다. 통신사 사전승인이 필요하므로 **cs@portone.io ** 로 다날 CPID 와 함께 사용승인 요청이 필요합니다.
carrier
string
휴대폰번호의 통신사
통신사 사전승인이 필요하므로 **cs@portone.io ** 로 다날 CPID 와 함께 사용승인 요청이 필요합니다.
SKT
KT
LGT
SKT_MVNO
KT_MVNO
LGT_MVNO
certified
boolean
인증성공여부
certified_at
string
인증처리시각
(UNIX timestamp)
unique_key
string
개인 고유구분 식별키 (CI
)
unique_in_site
**string
가맹점 내 개인 고유구분 식별키 (DI
)
origin
string
본인인증 프로세스가 진행된 웹 페이지의 URL
foreigner_v2
boolean
외국인 여부(nullable)
true : 외국인
false : 내국인
다날 본인인증서비스 계약시 외국인 구분기능 추가 요청필요
Swagger Test Link
Last updated