AI로 연동하기
AI 도구가 페이플 문서를 근거로 연동 코드를 쓰게 하는 방법입니다.
문서를 직접 넘기거나 MCP로 연결하세요.
금액, 주문번호, 취소 처리처럼 되돌리기 어려운 부분은 테스트 환경에서 먼저 확인해주세요.
테스트 키는 테스트 환경과 확인사항 문서에 있습니다.
AI 연동방식 선택하기
AI 도구에 문서를 전달하는 방법은 두 가지입니다.
문서 직접 전달을 선택했다면
결제 방식을 정하지 않았다면 문서 목차(llms.txt)를,
정했다면 그 결제 방식의 문서 원문(Markdown)을 AI에 전달합니다.
연동 문서 화면 오른쪽 위의 Markdown 복사로 원문을 바로 붙여 넣어도 됩니다.
원문을 전달하면 AI가 함께 읽으니 따로 알려주지 않아도 됩니다.
- 국내, 해외, 정산지급대행은 인증 방식, 키, 성공 응답 코드, 승인 절차가 서로 다릅니다.
고른 문서 하나를 기준으로 구현하고, 다른 서비스의 키나 응답 코드를 섞지 마세요. - custKey, service_key, PCD_REFUND_KEY 처럼 외부에 노출되면 안 되는 키는 서버에서만 사용하세요.
clientKey는 결제창을 호출하는 JavaScript에서 쓰는 클라이언트키이며, 등록한 도메인에서만 동작합니다.
테스트와 라이브 키는 환경별로 분리하세요. - 문서에 없는 파라미터나 값은 만들어 넣지 말고, 확인이 필요하다고 알려 주세요.
요청문 만들기
결제 방식과 개발 환경을 고르면 요청문이 바뀝니다. 복사해서 AI 도구에 붙여 넣으세요.
페이플 결제를 연동하려고 해.
개발 환경: 프론트 React, 서버 Java / Spring
아래 문서 목차를 읽고 내 서비스에 맞는 결제 방식을 먼저 추천해줘. 결제 방식이 정해지면 그 문서 하나를 기준으로 구현 계획을 작성해줘.
문서에서 확인되지 않는 값은 추정하지 말고 알려줘.
https://docs.payple.kr/llms.txtMCP 연동을 선택했다면
AI가 연동 중 필요한 페이플 문서를 직접 찾아 근거로 씁니다.
키 없이 연결됩니다.
MCP 서버 연결하기
https://mcp.payple.kr/mcp사용하는 AI 도구를 고르면 연결 방법이 바뀝니다.
Claude Code와 Codex는 터미널 명령 한 줄로, Cursor와 VS Code는 설정 파일에 추가합니다.
claude mcp add --transport http payple https://mcp.payple.kr/mcp
Claude Code에서 /mcp를 입력해 payple이 연결됐는지 확인하세요.
그 밖의 MCP 클라이언트는 서버 URL에 https://mcp.payple.kr/mcp를 넣으세요.
외부 도메인 접속을 막아둔 환경에서는 연결할 수 없습니다.
MCP 서버가 제공하는 도구
질문에 맞는 도구를 AI가 골라 씁니다.
보통 search_api_doc으로 문서를 찾고, 받은 주소를 get_api_details에 넣어 원문을 읽은 뒤 답합니다.
| 도구 | 하는 일 |
|---|---|
search_api_doc | "빌링키로 정기결제 승인하는 API 알려줘"처럼 연동 질문을 하면 → AI가 관련 문서를 검색해 문서 제목과 절 주소를 근거로 받습니다 |
list_available_apis | "어떤 결제 방식 문서가 있어?"처럼 묻거나 검색 결과가 비면 → AI가 문서 목차(22개 문서의 id, 제목, 분류, 요약)를 봅니다 |
get_api_details | 찾은 문서의 자세한 내용이 필요할 때 → AI가 그 절의 원문(파라미터 표, 예시, 응답 코드)을 읽습니다. 긴 문서는 목차부터 받습니다 |
get_example_code | "빌링키 해지 요청 JSON 예시 보여줘"처럼 코드만 필요할 때 → AI가 문서에 실린 코드 블록만 가져옵니다 |
연결하면 연동 원칙(서비스별 키와 응답 코드를 섞지 않기, 문서에 없는 값 만들지 않기, 비밀키와 금액 검증은 서버에서)이 AI에 자동으로 전달됩니다.
호출 한도
문서 검색에는 하루 한도가 있고, 사무실처럼 여러 명이 같은 IP를 쓰면 함께 씁니다.
한도에 걸려도 문서 목차와 원문 읽기는 계속 됩니다.
연결이 안 될 때
오류 메시지에 기다릴지, 원문을 볼지가 함께 안내되어 AI가 읽고 판단합니다.
직접 확인할 때는 해당 항목을 눌러 보세요.
그래도 해결되지 않으면 지니봇에 물어보거나 페이플 지니 깃허브에 사용 중인 AI 도구, 오류 메시지, request_id를 함께 남겨 주세요.
이렇게 물어보세요
두 연동방식 모두 아래처럼 물어보면 됩니다.
MCP를 연결했다면 질문만 하면 AI가 필요한 문서를 직접 찾습니다.
텍스트 방식이라면 문서 목차(llms.txt)나 원문(Markdown)을 함께 전달한 뒤 물어보세요.
빌링키로 정기결제 승인하는 API 알려줘결제창 호출할 때 PCD_PAY_TYPE에 넣을 수 있는 값은?응답 코드 INDEX0001은 무슨 뜻이야?계좌이체 결제를 취소하려면 어떻게 요청해?카드사 기관코드 목록 보여줘카드 정기결제 빌링키 해지 요청 JSON 예시 보여줘