PG사 API 연동문서를 OpenAPI로 변환하기
국내 PG 연동은 아직도 PDF 연동매뉴얼에서 시작합니다. 이니시스 표준결제, KCP 거래등록·승인, 나이스페이 인증결제 — 어느 쪽이든 수십 페이지 매뉴얼에서 요청 파라미터 표를 눈으로 읽고 손으로 옮겨 적는 작업이 첫 관문입니다.
pdf2api는 그 매뉴얼을 업로드하면 엔드포인트·파라미터·인증 구조를 추출해 OpenAPI 3.1 스펙과 Postman 컬렉션, Java/PHP/TypeScript SDK 초안까지 만들어 줍니다. 반나절 걸리던 전사(轉寫) 작업이 미리보기 30초 + 검토 시간으로 줄어듭니다.
PG 매뉴얼이 유독 고통스러운 이유
PG 연동문서는 일반 REST API 문서와 결이 다릅니다. 같은 표 안에 PC/모바일 파라미터가 병합셀로 섞여 있고, 요청 필드 설명에 "SEED 암호화 후 Base64" 같은 절차가 산문으로 끼어 있으며, 승인·취소·망취소가 페이지를 넘나들며 흩어져 있습니다.
이걸 손으로 옮기다 누락 하나가 생기면, 테스트 결제에서는 통과하고 운영의 특정 케이스에서만 터지는 버그가 됩니다. 자동 추출은 적어도 "옮겨 적다 빠뜨리는" 류의 실수를 만들지 않습니다.
- •병합셀·페이지 분할 파라미터 표 — 표가 페이지를 넘어가도 하나의 스키마로 복원
- •SEED/ARIA 본문 암호화, 해시·HMAC 서명 규칙 — OpenAPI로 표현 불가한 부분은 버리지 않고 "직접 구현 필요" 경고로 명시
- •거래등록 → 인증 → 승인 멀티스텝 플로우의 엔드포인트 분리 추출
- •한·영 혼용 필드 설명, PG 고유 용어(가맹점 키, MID, TID 등) 보존
추출 결과로 바로 할 수 있는 것
추출된 OpenAPI 스펙은 사내 API 게이트웨이·문서 포털·코드젠 어디든 들어갑니다. Postman 컬렉션은 PG 테스트베드에 바로 요청을 날려볼 수 있는 상태로 나오고, SDK 초안은 모델 클래스와 클라이언트 보일러플레이트를 대신 써 줍니다.
암호화·서명처럼 손으로 구현해야 하는 부분은 스펙과 SDK 문서 양쪽에 경고로 표시되어 있어서, "뭘 직접 짜야 하는지" 목록이 처음부터 명확합니다. 이 정직한 경고가 pdf2api의 핵심 설계입니다.
자주 묻는 질문
어느 PG사 문서를 지원하나요?
특정 PG 전용이 아니라 문서 구조를 읽는 방식이라, 이니시스·KCP·나이스페이·토스페이먼츠·다날 등 PDF/Word/Excel로 제공되는 연동매뉴얼 전반에 동작합니다. 무료 미리보기로 먼저 추출 품질을 확인하세요.
SEED 암호화나 서명 로직도 코드로 생성되나요?
아니요 — 그건 OpenAPI로 표현할 수 없는 영역이라, 조용히 누락시키는 대신 "직접 구현 필요" 경고로 명시합니다. 무엇을 손으로 짜야 하는지가 처음부터 목록으로 나옵니다.
업로드한 연동매뉴얼은 어떻게 처리되나요?
변환이 끝나면 즉시 영구 삭제됩니다. 미결제 업로드는 24시간 내 자동 삭제됩니다.
가격은 어떻게 되나요?
모든 문서 미리보기는 무료입니다. 전체 내보내기는 문서 분량 기준 건당 결제 — 10페이지 이하 $5, 40페이지 이하 $12, 그 이상 $29.
지금 연동 중인 PG 매뉴얼로 테스트해 보세요
미리보기는 무료 — 추출된 엔드포인트를 먼저 확인하고 결정하세요.
연동문서 업로드 →