일반적인 API 테스트는 가맹점에서 PG사로 요청을 보내고 응답을 받는 구조예요. 하지만 노티(결과통보) 는 반대로 PG사에서 가맹점으로 요청을 보내는 구조이기 때문에 테스트 방법이 달라요.
노티를 수신하려면 가맹점 서버가 외부에서 접근 가능한 URL 을 가지고 있어야 해요. 로컬 개발 환경에서는 localhost가 외부에서 접근 불가능하기 때문에 별도의 설정이 필요해요.
webhook.site는 노티 테스트를 위한 무료 서비스예요. 별도 설치 없이 바로 사용할 수 있어서 가장 간편해요.
사용 방법
https://webhook.site/abc123...)notiUrl 파라미터에 해당 URL을 설정해요장점
단점
ngrok은 로컬 서버를 외부에서 접근 가능하게 터널링해주는 도구예요. 실제 비즈니스 로직까지 테스트하려면 이 방법을 사용하세요.
설치 및 실행
# macOS (Homebrew)
brew install ngrok
# Windows (Chocolatey)
choco install ngrok
# 또는 공식 사이트에서 직접 다운로드
# https://ngrok.com/download
사용 방법
# 1. 로컬 서버 실행 (예: 3000번 포트)
npm run dev
# 2. 새 터미널에서 ngrok 실행
ngrok http 3000
# 3. 발급된 HTTPS URL 확인
# Forwarding https://abc123.ngrok.io -> http://localhost:3000
발급된 URL을 notiUrl로 사용해요:
https://abc123.ngrok.io/api/payment/noti
장점
단점
개발/스테이징 서버가 외부에서 접근 가능하다면, 해당 서버의 노티 수신 엔드포인트를 notiUrl로 설정하여 테스트할 수 있어요.
https://dev.example.com/api/payment/noti
노티 연동 시 아래 항목들을 반드시 확인해야 해요.
pktHash 값이 서버에서 계산한 해시와 일치하는지OK만 반환하는지 (공백, 줄바꿈 없이)outStatCd에 따른 분기 처리가 정상 작동하는지가상계좌는 여러 종류의 노티가 발생해요:
outStatCd: 0051, bizType: A0): 계좌 발급 시 처리outStatCd: 0021, bizType: B1): 실제 입금 완료 시 처리outStatCd: 0021, bizType: A2): 채번 취소 시 처리notiUrl 파라미터가 올바르게 설정되었는지 확인OK 외의 문자(공백, 줄바꿈 포함)가 응답에 포함되지 않았는지 확인연동 중 문의사항은 기술지원팀()으로 연락 주세요.