본문으로 건너뛰기

llms.txt 활용하기

llms.txt는 AI 도구가 NICEPAY PG 개발자센터의 문서 구조를 빠르게 파악할 수 있도록 제공하는 문서 인덱스입니다. AI에게 결제 연동 질문을 할 때 llms.txt를 함께 전달하면, AI가 필요한 문서의 위치와 역할을 더 정확하게 찾는 데 도움이 됩니다.

이 문서는 NICEPAY PG 개발자센터의 llms.txt를 AI 도구에서 활용하는 방법과 질문 예시를 안내합니다.

1. llms.txt란?​

llms.txt는 LLM이 웹사이트의 주요 문서와 경로를 이해하기 쉽도록 정리한 텍스트 파일입니다.

NICEPAY PG 개발자센터의 llms.txt에는 아래와 같은 정보가 포함됩니다.

구분설명
문서 기본 정보NICEPAY PG 개발자센터의 목적, 기본 URL, 문서 상태
주요 연동 문서인증 결제, 비인증 결제, PAYU, 조회, 부가 서비스 문서
코드 문서카드사/은행 코드, 결과 코드 문서
활용 안내AI 질문 시 우선 참고할 문서와 보안 유의사항

AI 도구는 이 파일을 참고해서 사용자의 질문에 맞는 문서를 찾고, 문서 기준으로 답변을 구성할 수 있습니다.

2. 제공 위치​

NICEPAY PG 개발자센터의 llms.txt는 아래 경로에서 제공합니다.

https://developers.nicepay.co.kr/llms.txt

사내망 또는 별도 도메인으로 배포하는 경우에는 배포된 개발자센터의 루트 경로에서 확인합니다.

https://{NICEPAY_PG_DEVELOPER_CENTER_URL}/llms.txt

정적 파일 기준으로는 프로젝트의 static/llms.txt 파일이 빌드 후 사이트 루트의 /llms.txt로 제공됩니다.

3. 활용 방법​

AI 도구마다 llms.txt를 처리하는 방식은 다를 수 있습니다. 가장 안정적인 방법은 질문할 때 llms.txt 주소를 직접 알려주고, 해당 파일을 기준으로 답변하라고 명시하는 것입니다.

3.1. URL을 전달하는 방식​

AI 도구가 웹 URL을 읽을 수 있다면 아래처럼 질문합니다.

https://developers.nicepay.co.kr/llms.txt 를 참고해서 NICEPAY 결제창 호출 연동 순서를 알려줘.
NICEPAY PG 개발자센터의 llms.txt를 먼저 확인한 뒤, 비인증 카드키인 API 연동에 필요한 문서를 찾아서 요약해줘.

3.2. 파일 내용을 첨부하는 방식​

인터넷 연결이 제한된 환경에서는 llms.txt 파일 내용을 AI 도구의 컨텍스트로 직접 첨부할 수 있습니다.

첨부한 llms.txt는 NICEPAY PG 개발자센터 문서 인덱스입니다.
이 내용을 기준으로 가상계좌 발급 API와 입금통보 연동 시 확인해야 할 문서를 알려줘.

3.3. MCP와 함께 사용하는 방식​

MCP 서버가 연결된 환경에서는 llms.txt를 문서 탐색의 출발점으로 사용하고, 상세 내용은 MCP 문서 조회를 통해 확인하도록 요청할 수 있습니다.

llms.txt로 관련 문서 경로를 먼저 찾고, NICEPAY MCP 문서를 조회해서 승인 API 요청 파라미터와 응답 파라미터를 정리해줘.

4. 질문 예시​

AI 도구에 질문할 때는 "NICEPAY 문서 기준", "llms.txt 참고", "MCP 문서 조회"처럼 참고 기준을 명시하는 것이 좋습니다.

4.1. 결제 연동 흐름 확인​

NICEPAY llms.txt를 참고해서 인증 결제의 결제창 호출, 승인 API, 망취소 API 흐름을 순서대로 설명해줘.
PC 결제창 호출과 모바일 결제창 호출에서 가맹점이 처리해야 하는 차이를 문서 기준으로 정리해줘.

4.2. API 파라미터 확인​

llms.txt에서 비인증 결제 관련 문서를 찾고, 카드키인 API의 필수 요청 파라미터와 서명 생성 규칙을 알려줘.
가상계좌 발급 API 문서를 기준으로 요청 파라미터와 입금통보 연동 시 확인해야 할 항목을 정리해줘.

4.3. 결과 코드 확인​

NICEPAY 결과 코드 문서 중 가상계좌 승인 결과 코드 문서를 찾아서 4100, 4110, 4120 코드의 의미를 알려줘.
API 공통 오류코드 문서를 기준으로 ResultCode가 실패인 경우 가맹점이 확인해야 할 항목을 알려줘.

4.4. WebView 연동 확인​

llms.txt에서 APP WebView 연동 문서를 찾고, Android에서 3rd 앱 호출을 위해 AndroidManifest.xml에 설정해야 하는 항목을 알려줘.
iOS WKWebView에서 카드사 앱 호출이 실패할 때 확인해야 할 URL Scheme 설정을 문서 기준으로 정리해줘.

5. 답변 검증 기준​

AI 답변은 개발 보조 수단이므로 실제 연동 전에는 반드시 문서와 테스트 환경에서 다시 검증해야 합니다.

확인 항목설명
문서 경로AI가 참조한 문서가 실제 개발자센터에 존재하는지 확인
요청 파라미터필수 여부, 크기, 인코딩, 서명 생성 규칙 확인
응답 파라미터성공/실패 코드, 추가 필드 처리 방식 확인
예시 데이터문서 예시는 테스트 이해용이므로 실제 운영 요청에 그대로 사용하지 않음
보안 정보MerchantKey, 운영 MID, 개인정보, 카드번호, 계좌번호를 AI 도구에 입력하지 않음

특히 SignData, encKey 같은 위변조 검증 데이터는 문서의 생성 규칙과 가맹점 테스트 환경에서 반드시 재검증해야 합니다.

6. 주의사항​

  • llms.txt는 문서 탐색을 돕는 인덱스이며, API 원문 전체를 대체하지 않습니다.
  • 상세 파라미터, 결과 코드, 예외 처리는 각 기술문서 페이지를 기준으로 확인해야 합니다.
  • 사내망에서 사용하는 경우 배포 도메인에 맞게 /llms.txt 접근 가능 여부를 확인합니다.
  • 문서가 수정되면 static/llms.txt도 최신 문서 구조에 맞게 갱신해야 합니다.
  • AI 도구가 일반 지식으로 답변하는 경우 "NICEPAY llms.txt와 MCP 문서를 기준으로 답변해줘"라고 명시합니다.

7. 관련 문서​

문서설명
MCP 연동하기AI 개발 도구에서 NICEPAY 문서를 MCP 서버로 조회하는 방법
llms.txtNICEPAY PG 개발자센터 문서 인덱스