연동 정보

현재 적용된 KISPG 연동 설정과, 실연동 전환 전에 확인해야 할 항목입니다.

환경

연동 환경

개발계(testapi.kispg.co.kr)

동작 모드

Mock — KISPG 서버에 연결하지 않음

서비스 주소

https://pg.geekdive.cc

상점 계정

결제 상점아이디

kistest00m

결제 상점키

2d6ECG…qg== (88자)

빌링 상점아이디

billing00m

빌링 상점키

dlKA9Q…PQ== (88자)

매출집계 계정

미설정 — Mock 데이터로 동작

엔드포인트

현재 환경에서 실제로 호출되는 주소

인증 요청

/api/mock/checkout(실연동 시 https://testapi.kispg.co.kr/v2/auth)

승인

https://testapi.kispg.co.kr/v2/payment

취소

https://testapi.kispg.co.kr/v2/cancel

단건 조회

https://testapi.kispg.co.kr/v2/order

거래확인서

https://testapi.kispg.co.kr/v2/receipt

빌링

https://testapi.kispg.co.kr/v2/billing/{issue,payment,delete,cancel,validate}

매출집계

https://testdata.kispg.co.kr/v2/static/vanpg

수신 URL

KISPG가 우리 서버로 호출하는 주소

인증 결과(returnUrl)

https://pg.geekdive.cc/api/kispg/return

결제통보(webhook)

https://pg.geekdive.cc/api/kispg/notify

실연동 전환 체크리스트

Mock 모드 해제
KISPG_MOCK=0으로 바꾸면 실제 KISPG 서버를 호출합니다.
외부에서 접근 가능한 HTTPS 주소
인증 결과와 결제통보는 KISPG가 우리 서버로 POST합니다. localhost로는 받을 수 없습니다. 개발 중에는 ngrok 등 터널 주소를 NEXT_PUBLIC_APP_URL에 넣으세요. returnUrl은 255byte 제한이 있습니다.
결제통보 URL 등록수동 확인 필요
mms.kispg.co.kr 가맹점 관리자 → 가맹점정보 → 결제환경 설정 → 결제결과 통보관리에서 위 통보 URL을 등록해야 합니다. API로는 설정할 수 없습니다.
방화벽 — 인바운드 허용수동 확인 필요
KISPG 출발지 IP(운영 1.233.179.201 / 개발 61.40.40.74)에서 443으로 들어오는 요청을 허용해야 합니다. 80/443이 아닌 포트를 쓰면 KISPG에 별도 신청이 필요합니다.
방화벽 — 아웃바운드 허용수동 확인 필요
api.kispg.co.kr(운영) / testapi.kispg.co.kr(개발), data.kispg.co.kr로 나가는 HTTPS를 허용해야 합니다.
매출집계 API 계정
상점키와 별개로 발급되는 id/pw가 필요합니다. KISPG_SETTLEMENT_ID / KISPG_SETTLEMENT_PW에 넣으세요.
대사 파일 SFTP 계정수동 확인 필요
PG수수료·부가세·입금액이 들어 있는 유일한 소스가 대사 파일입니다. SFTP 61.40.18.69:51022로 받으며 ID/PW는 KISPG가 별도 제공합니다. 대사는 개발계 환경이 없습니다.
MID 기능 설정 확인수동 확인 필요
선할인·가맹점수수료·전송금액기준(공급가/부가세)·컵보증금 사용 여부에 따라 필수 파라미터가 달라집니다. 가맹점관리자 → 가맹점정보 → 일반정보에서 확인하세요.

테스트 MID 주의

문서에서 제공하는 테스트 상점아이디(kistest00m)로 결제해도 실제 카드 승인이 일어납니다. 해당 거래는 당일 23:30에 자동 취소됩니다. 취소·조회 테스트를 하려면 거래번호(TID)를 그 전에 확보해 두세요.