⌨ī¸Request identity verification API

Sends OTP number via SMS confirming the user's identity based on the submitted personal information.

Sends OTP number confirming user's identity via SMS.

POST https://api.iamport.kr/certifications/otp/request

If the user's personal information is passed to the API and verified by the carrier, an OTP (6-digit verification number) is sent to the user via SMS. This is only supported by some merchants who have been pre-approved by the carrier, and is currently only being serviced through Danal.

You can call the API by directly entering the name, date of birth + 7th digit of social security number, mobile phone number, and carrier information from the merchant. If the transmitted personal information is correct, a verification code SMS is sent to the mobile phone.

When you receive an HTTP Status 200 response, it contains the verification ID (imp_uid) in the response body. To complete the verification process, call the /certifications/otp/confirm/{imp_uid} API with the OTP number.

Request Body

NameTypeDescription

name*

String

User name

phone*

String

Mobile number

May contain special characters.

birth*

String

DOB

YYYYMMDD (6-digit)

May contain special characters.

gender_digit*

String

Gender code

7th digit of 13-digit social security number

carrier*

String

Carrier code

SKT

KT

LGT

is_mvno

Boolean

Budget phone?

company

String

Merchant service name

merchant_uid

String

Order ID

pg

String

PG code

{
    // Response
}

Key request parameter description

gender_digit*String

Gender code

7th digit of 13-digit social security number

1 or 2 for those born before 2000, 3 or 4 those born on or after 2000 (odd: male, even: female)

carrier*String

Carrier code

For budget phone users, set carrier to one of SKT, KT, or LGT, and set

is_mvno : true

company*String

Merchant service name

Service name to use in the SMS sent by KISA

pg String

PG code

Specify this value as follows only when you are using multiple Danal Merchant IDs.

danal.{Merchant ID}

Response Model Schema
{
  "code": 0,
  "message": "string",
  "response": {
    "imp_uid": "string"
  }
}

Last updated