Developers
V1
V2

Get verification info

Fetch the verification information and use it for identity verification purposes.

Use the imp_uid obtained through integrated identity verification to get the customerโ€™s verification information.

STEP 01. Get verification ID (imp_uid) on the server-side

The following server-side code fetches the data returned from identity verification.

server-side
app.use(bodyParser.json()); // controller that handles POST request to "/certifications" app.post("/certifications", async (request, response) => { // Get imp_uid from req.body const { imp_uid } = request.body; });

STEP 02. Get verification information

To get verification information from the iโ€™mport server, you must first get a REST API access token. Use the access token and imp_uid (verification ID) to call the Get identity verification info REST API that returns the verification information as follows:

sever-side(Node.js)
app.use(bodyParser.json()); // controller that handles POST request to "/certifications" app.post("/certifications", async (request, response) => { const { imp_uid } = request.body; // Get imp_uid from request.body try { // Get access token const getToken = await axios({ url: "https://api.iamport.kr/users/getToken", method: "post", // POST method headers: { "Content-Type": "application/json" }, // "Content-Type": "application/json" data: { imp_key: "imp_apikey", // REST API Key imp_secret: "ekKoeW8RyKuT0zgaZsUtXXTLQ4AhPFW3ZGseDA6bkA5lamv9OqDMnxyeB9wqOsuO9W3Mx9YSJ4dTqJ3f", // REST API Secret }, }); const { access_token } = getToken.data.response; // Access token // Get verification info from i'mport server using imp_uid const getCertifications = await axios({ url: `https://api.iamport.kr/certifications/${imp_uid}`, // Pass imp_uid method: "get", // GET method headers: { Authorization: access_token }, // Add access token to Authorization header }); const certificationsInfo = getCertifications.data.response; // Save verification info } catch (e) { console.error(e); } });

STEP 03. Using verification information

Retrieve the following user information from the verification information and add the necessary service logic.

  • name: name

  • gender: gender (to be supported)

  • birth: date of birth

  • unique_key: same as CI value - unique key to identify the user, such as online social security number.

Besides what is listed above, other user information, such as foreigner status, is not provided. Kakaoโ€™s policy prohibits the provision of the CI value when using the Kakao Certificate.

Get the user information and use it as needed. For example, you can use it to check age restrictions as follows:

Node.js
// controller that handles POST request to "/certifications" app.post("/certifications", async (request, response) => { const { imp_uid } = request.body; // Get imp_uid from request.body try { // Get access token /* ...Omitted... */ // Get verification info using imp_uid /* ...Omitted... */ const certificationsInfo = getCertifications.data.response; // Save verification info const { name, birth } = certificationsInfo; // Check age restrictions if (new Date(birth).getFullYear() <= 1999) { // Check successful } else { // Check failed } } catch (e) { console.error(e); } });