자주 묻는 질문

"허용된 IP 접근이 아닙니다"(-2417, 401)는 어떻게 푸나요?

업데이트 2026-09-10

REST API를 호출한 서버의 공인 IP가 부트페이 관리자의 접근 허용 IP 목록에 없어서 막힌 것입니다. 관리자의 결제 키 및 보안 화면에 있는 IP 보안 탭에 그 서버 IP를 등록하면 풀립니다. 로컬에서 테스트할 때 127.0.0.1을 넣으면 안 되고, 그 PC가 인터넷에 나갈 때 쓰는 공인 IP를 넣어야 합니다.

어디서 등록하나

관리자 콘솔의 결제 설정 > 결제 키 및 보안 메뉴에 IP 보안 탭이 있습니다. 여기에 REST API를 호출하는 서버의 공인 IP를 넣습니다.

자주 막히는 지점

  • 로컬 개발 중이라 127.0.0.1을 등록했습니다. 부트페이가 보는 것은 요청이 나온 공인 IP입니다.
  • 서버를 늘렸는데 새 인스턴스의 IP를 안 넣었습니다. 오토스케일 환경이면 NAT 게이트웨이의 고정 IP를 등록합니다.
  • 개발 서버와 운영 서버가 다른 프로젝트를 쓰는데 한쪽에만 등록했습니다.

더 읽어 보기

답을 찾지 못했다면 물어보세요