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-sideapp.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; });
server-sideapp.use(bodyParser.json()); // controller that handles GET request to "/certifications/redirect" app.get("/certifications/redirect", async (request, response) => { const { imp_uid } = request.query; // Get imp_uid from req.query });
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 -
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); } });