페이플 개발자센터가 새로워졌습니다. 이제 AI 도구에게 결제 연동을 맡겨도 페이플 문서 그대로 코드를 작성합니다.
요즘 결제 연동은 AI와 함께 합니다
요즘 개발자분들은 결제 연동을 시작할 때 문서보다 AI 도구를 먼저 엽니다. "이 PG로 정기결제 붙여줘"라고 물어보는 식입니다.
문제는 AI가 문서를 제대로 읽지 못하면 그럴듯한 가짜 파라미터를 지어낸다는 점입니다. 테스트에서 막히고, 다시 문서를 뒤지고, 시간이 두 배로 듭니다.
그래서 페이플은 개발자센터를 사람뿐 아니라 AI도 정확히 읽을 수 있도록 새로 만들었습니다.
이렇게 달라졌습니다
•
결제 방식부터 고르면 끝: 국내·해외로 나누고, 원하는 결제 방식을 고르면 해당 연동 문서로 바로 이동합니다. 일반 결제, 정기(빌링) 결제, 링크 결제, 정산지급대행, 대사까지 한곳에 있습니다.
•
•
문서 원문 복사: 문서 화면 오른쪽 위 "Markdown 복사" 버튼을 누르면 연동 과정과 파라미터가 그대로 복사됩니다. AI 도구에 붙여 넣으면 됩니다.
•
요청문 만들기: 결제 방식과 개발 환경(React, Vue, Node.js, Java/Spring, PHP, Python 등)을 고르면 AI에게 줄 요청문을 자동으로 만들어 드립니다.
•
운영 문서도 한곳에: 결제 이후 필요한 취소, 결과 조회, 빌링키 관리, 현금영수증, 정산 이체 조회 문서를 모았습니다.
•
지니봇: 개발자센터 문서와 지난 기술 문의를 근거로 답하는 결제 연동 AI 어시스턴트입니다.
AI에게 이렇게 맡기세요
1.
2.
결제 방식을 정했다면 그 문서 하나의 원문을 "Markdown 복사"로 복사해서 AI 도구에 붙여 넣으세요.
3.
4.
AI가 만든 코드는 꼭 테스트 환경에서 먼저 확인하세요. 금액, 주문번호, 취소 처리는 실제 돈이 오가는 부분이라 사람이 한 번 더 확인해야 합니다.
AI가 실수하지 않도록 문서에 넣어둔 원칙
•
국내, 해외, 정산지급대행은 키와 성공 응답 코드가 서로 다릅니다. 한 문서를 기준으로 구현하고 다른 서비스의 값을 섞지 않도록 안내합니다.
•
custKey 같은 서버용 키는 서버에서만 쓰도록 안내합니다.
•
문서에 없는 파라미터나 값은 지어내지 말고 "확인이 필요하다"고 알리도록 안내합니다.
자주 묻는 질문
Q. 어떤 AI 도구에서 쓸 수 있나요?
특정 도구를 정해두지 않았습니다. 문서 주소와 원문을 읽을 수 있는 AI 도구라면 어디서든 쓸 수 있습니다.
Q. 예전 개발자센터 문서는 없어졌나요?
아닙니다. 상단 메뉴에서 신버전과 구버전 개발자센터를 오가며 볼 수 있습니다.
Q. 계약 전에도 테스트해볼 수 있나요?
네. 테스트 키와 테스트·라이브 차이는 개발자센터의 "테스트 환경과 확인사항" 문서에 있습니다.
Q. 연동하다 막히면 어디에 물어보나요?