본문으로 건너뛰기

LLM(Large Language Model)

이지페이(EasyPay) 온라인 결제는 AI 기반 코딩 도구(ChatGPT, Claude, 등)가 결제 연동 코드를 더 정확하게 작성할 수 있도록, LLM 전용 학습 데이터와 설정 가이드를 제공합니다.

개발 환경에 맞는 방법을 선택하여 복잡한 결제 연동을 10배 더 빠르게 완료하세요.

AI 학습 리소스 다운로드​

사용하는 도구에 맞춰 아래 파일들을 활용하세요.

파일명설명URL
llms.txt핵심 API 리스트와 문서 링크만 포함.https://docs.kicc.co.kr/online/llms.txt
llms-full.txt온라인 결제의 모든 API 상세 규격과 예제가 포함된 전체 텍스트.https://docs.kicc.co.kr/online/llms-full.txt
💡 llms.txt란?

llms.txt는 사람이 아닌 AI 모델이 웹사이트의 내용을 효율적으로 학습할 수 있도록 고안된 마크다운 기반의 표준 파일 형식입니다.

LLM을 활용한 온라인 결제 연동하기​

인터넷 브라우징 기능이 있는 AI 모델에게는 URL을, 없는 모델에게는 전체 텍스트를 제공하는 것이 좋습니다.

시나리오 A: GPT-4o / Perplexity (Web Access 가능)​

프롬프트에 llms.txt 링크를 포함하면 가장 최신 정보를 바탕으로 답변합니다.

프롬프트 예시: "아래 이지페이 명세서를 참조해서 Node.js로 결제 승인 로직을 짜줘. 문서 URL: https://docs.kicc.co.kr/online/llms.txt

[요청사항]

  1. Axios 라이브러리 사용
  2. 타임아웃 30초 설정
  3. 에러 발생 시 로그 출력 (카드정보 등 민감정보 마스킹 필수)"

시나리오 B: Claude 3.5 Sonnet / Local LLM (파일 업로드)​

브라우징보다 파일 업로드가 더 정확도가 높습니다. llms-full.txt 파일을 다운로드하여 채팅창에 업로드하세요.

프롬프트 예시: "(파일 업로드 후) 이 문서는 이지페이(EasyPay) 결제 API 전체 명세서야. 이걸 바탕으로 Java Spring Boot 결제 컨트롤러를 만들어줘. 결제 승인 실패 시(특히 타임아웃 시) 자동으로 망취소 API를 호출하는 로직을 꼭 포함해줘."

필수 보안 체크리스트​

AI가 코드를 작성해주더라도, 최종 보안 책임은 개발자에게 있습니다. 배포 전 다음 항목을 반드시 확인하세요.

  1. 상점 아이디(Mall ID) 하드코딩 여부:
    • ❌ const mallId = "055...";
    • ✅ const mallId = process.env.EASYPAY_MALL_ID;
  2. 민감 정보 로깅:
    • 고객의 결제 정보나 개인정보가 서버 로그에 평문으로 남지 않도록 마스킹 처리되었는가?
  3. 예외 처리:
    • 네트워크 타임아웃 발생 시, 결제 상태가 '미결'로 남지 않도록 거래상태 조회로 확인하세요.

관련 문서​