클로드로 KCP 결제창 연동하기

NHN KCP 표준결제를 JSP로 연동할 프로젝트를 만들어줘.

[목표]
내 컴퓨터에서 JSP 로컬 서버를 실행하고 브라우저에서 "Hello KCP" 화면을 확인합니다.

[작업]
- 현재 컴퓨터에서 JSP 실행 환경과 버전 확인
- 실행 환경이 없으면 현재 OS에 맞는 방법으로 직접 자동 설치까지 진행
- 자동 설치가 불가능한 경우에만 이유와 함께 쉬운 수동 설치 방법 안내
- 설치가 끝나면 버전과 정상 실행 여부까지 확인
- 프로젝트명: kcp-standard-pay
- 프로젝트 구조: Tomcat 웹앱 프로젝트
- HTTP 요청과 JSON 처리를 위한 라이브러리 준비
- 첫 화면에 "Hello KCP" 문구 표시
- 세션은 HttpSession 방식으로 구성

[주의]
- 중간에 확인받지 말고, 직접 만들 수 있는 파일과 설정은 바로 진행
- 내가 직접 클릭하거나 입력해야 하는 작업만 마지막에 따로 안내
- 선택한 언어와 현재 컴퓨터 환경이 맞지 않으면 이유와 준비 방법을 쉽게 설명

[완료 기준]
Tomcat 실행 후 http://localhost:8080/kcp-standard-pay/ 접속

[완료 후 알려줄 것]
- 만든 파일과 수정한 파일
- 실행 명령어와 접속 URL
- 정상 화면 기준과 다음 단계 전 확인값

[정상 기준] 브라우저에서 Hello KCP 화면이 열리는지 확인합니다.

앞 단계에서 받은 approvalKey와 PayUrl로 모바일 결제창 호출 화면을 만들어줘.

[만들 파일]
- 모바일 결제창 호출 및 인증 결과 수신 화면: order_mobile.jsp

[결제창 호출]
- 모바일 결제창은 팝업이나 iframe이 아니라 PayUrl로 form submit하여 화면 전체를 이동
- approvalKey는 결제창 호출 시 approval_key 이름으로 전달
- 필수 전송값: site_cd, ordr_idxx, good_mny, good_name, currency=410, pay_method, approval_key, Ret_URL, PayUrl
- 선택값: shop_name=TEST SITE, buyr_name, buyr_tel2, buyr_mail, quotaopt=12, encoding_trans=UTF-8

[call_pay_form 처리]
- encoding_trans가 UTF-8이면 PayUrl의 마지막 / 앞부분에 /jsp/encodingFilter/encodingFilter.jsp를 붙여 submit
- /jsp/encodingFilter/encodingFilter.jsp 경로는 KCP 고정 경로이므로 언어가 달라도 변경 금지

[인증 결과 처리]
- 페이지가 열릴 때 chk_pay 함수 실행
- chk_pay 맨 위에 self.name = "tar_opener"; 추가
- res_cd가 0000이면 enc_info, enc_data, tran_cd를 kcp_api_page.jsp로 전달
- res_cd가 3001이면 "사용자가 취소하였습니다" 표시
- 그 외 오류는 메시지를 보여주고 주문 입력 화면으로 이동

[주의]
- enc_info와 enc_data는 KCP가 내려준 암호화 값이므로 절대 수정하지 않기

[완료 기준]
모바일 결제창으로 이동하거나 인증 결과가 kcp_api_page.jsp 화면으로 전달되어야 합니다.

[완료 후 알려줄 것]
- 만든 파일과 수정한 파일
- 실행 명령어와 접속 URL
- 정상 화면 기준과 다음 단계 전 확인값

[정상 기준] 모바일 결제창으로 이동하거나 인증 결과가 승인 처리 화면으로 넘어가는지 확인합니다.

NHN KCP 표준결제 PC 결제창 호출 화면을 만들어줘.

[목표]
PC 환경에서 KCP 결제창 스크립트를 불러와 결제창을 실행하고 인증 결과를 받습니다.

[만들 파일]
- PC 결제창 호출 화면: order.html

[결제창 스크립트]
- 테스트 주소: https://testspay.kcp.co.kr/plugin/kcp_spay_hub.js

[주문 입력값]
- site_cd: T0000
- site_name: TEST SITE
- ordr_idxx: TEST + 현재 시각으로 자동 생성
- good_name: 운동화
- good_mny: 1004
- quotaopt: 12
- buyr_name, buyr_tel2, buyr_mail 입력
- pay_method: 신용카드 100000000000, 계좌이체 010000000000, 휴대폰 000010000000 중 선택
- 결제창이 채울 빈 값: res_cd, res_msg, enc_info, enc_data, tran_cd

[필수 함수]
- m_Completepayment(FormOrJson, closeEvent): 이름 변경 금지, 결제창 JS보다 먼저 선언
- GetField(frm, FormOrJson)로 결과값을 주문 폼에 채우기. 넘어온 FormOrJson을 직접 쓰지 말고 GetField로 frm에 채운 값만 사용
- res_cd가 0000이면 kcp_api_page.jsp로 submit
- 실패하면 res_cd와 res_msg를 보여주고 closeEvent() 호출
- jsf__pay(form): try { KCP_Pay_Execute_Web(form); } catch(e){} 형태로 실행. 정상 실행 시에도 throw가 발생하므로 catch는 비워두기

[주의]
- 결제 요청 시 ordr_idxx, good_mny, pay_method를 HttpSession에 저장
- transform, filter, perspective 같은 CSS는 상위 요소에 적용하지 않기
- KCP 함수명에는 변경 금지 주석 추가

[완료 기준]
PC 결제창이 열리고 인증 완료 후 kcp_api_page.jsp 화면으로 이동해야 합니다.

[완료 후 알려줄 것]
- 만든 파일과 수정한 파일
- 실행 명령어와 접속 URL
- 정상 화면 기준과 다음 단계 전 확인값

[정상 기준] PC 결제창이 열리고 인증 완료 후 승인 처리 화면으로 이동하는지 확인합니다.

KCP 결제 검증 규칙을 적용해줘.

[목표]
결제창에 보낸 값과 승인 요청 값이 일치하는지 확인해 8350 오류를 방지합니다.

[검증 기준]
- 결제금액: 결제창 good_mny == 승인요청 ordr_mony
- 결제수단: 결제창 pay_method == 승인요청 pay_type
- 주문번호: 결제창 ordr_idxx == 승인요청 ordr_no

[결제수단 변환표]
- PC 신용카드 100000000000 / 모바일 CARD → PACA
- PC 계좌이체 010000000000 / 모바일 BANK → PABK
- PC 휴대폰 000010000000 / 모바일 MOBX → PAMC

[작업]
- 모바일 거래등록과 PC 결제 요청 시 ordr_idxx, good_mny, pay_method를 HttpSession에 저장
- 승인 요청에서는 화면에서 넘어온 값보다 HttpSession에 저장된 값을 우선 사용
- pay_type을 고정하지 말고 저장된 pay_method 기준으로 변환
- 변환표에 없는 값이면 승인 요청을 보내지 않고 오류 처리
- KCP 승인 요청 전 서버에서 금액, 결제수단, 주문번호 일치 여부 확인
- 하나라도 다르면 승인 요청을 중단하고 어떤 값이 다른지 로그로 남기기
- 신용카드, 계좌이체, 휴대폰 테스트 방법을 마지막에 정리

[주의]
- 인증서, 개인정보, enc_data 전문은 로그에 남기지 않기
- PC와 모바일 흐름 모두에 적용
- 수정한 부분에는 "결제 검증 보완" 주석 추가

[완료 기준]
신용카드, 계좌이체, 휴대폰 모두 금액·주문번호·결제수단 검증이 통과해야 합니다.

[완료 후 알려줄 것]
- 만든 파일과 수정한 파일
- 실행 명령어와 접속 URL
- 정상 화면 기준과 다음 단계 전 확인값

[정상 기준] 신용카드, 계좌이체, 휴대폰 모두 금액·결제수단·주문번호 검증이 통과하는지 확인합니다.