본인확인 결과조회 API

인증 결과 Callback으로 받은 reg_cert_key를 가맹점에 저장된 거래등록키와 비교한 후, 거래등록 단계에서 저장한 주문번호와 함께 결과조회 API를 호출합니다.

// Callback 거래등록키 검증
String callbackRegCertKey = request.getParameter("reg_cert_key");
String storedRegCertKey   = loadRegCertKeyFromDatabase();
String storedOrderId      = loadOrderIdFromDatabase();

if (!storedRegCertKey.equals(callbackRegCertKey)) {
    throw new IllegalArgumentException("거래등록키가 일치하지 않습니다.");
}

// 본인확인 결과조회 요청 JSON 구성
JSONObject body = new JSONObject();
body.put("reg_cert_key", storedRegCertKey);
body.put("ordr_idxx", storedOrderId);

String jsonBody = body.toJSONString();

URL url = new URL("https://testcert.kcp.co.kr/api/query/getCertData.do");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();

conn.setDoOutput(true);
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("site_cd", "AO7F3");

try (OutputStream os = conn.getOutputStream()) {
    os.write(jsonBody.getBytes(StandardCharsets.UTF_8));
    os.flush();
}

// 정상 응답 데이터 복호화
JSONObject queryResult =
    (JSONObject) new JSONParser().parse(responseBody);

String resCd       = (String) queryResult.get("res_cd");
String encCertData = (String) queryResult.get("enc_cert_data");
String rv          = (String) queryResult.get("rv");

if ("0000".equals(resCd)) {
    String certDataJson =
        Crypto.decryptJson(encCertData, rv, encKey, siteCd);

    JSONObject certData =
        (JSONObject) new JSONParser().parse(certDataJson);

    // CI, DI, 이름, 생년월일 등 필요한 인증정보를 서버에서 처리
}

샘플은 세션에 거래등록키와 주문번호를 저장하지만, 운영 환경에서는 DB나 별도 보안 저장소에서 조회하고 Callback 값과 일치 여부를 검증하는 방식을 사용하세요. 결과조회가 끝난 거래등록키는 재사용되지 않도록 처리하는 것이 안전합니다.