에러 코드
"허용된 IP 접근이 아닙니다"(-2417, 401)는 어떻게 푸나요?
REST API를 호출한 서버의 공인 IP가 부트페이 관리자의 접근 허용 IP 목록에 없어서 막힌 것입니다. 관리자의 결제 키 및 보안 화면에 있는 IP 보안 탭에 그 서버 IP를 등록하면 풀립니다. 로컬에서 테스트할 때 127.0.0.1을 넣으면 안 되고, 그 PC가 인터넷에 나갈 때 쓰는 공인 IP를 넣어야 합니다.
이 코드로 들어온 상담 19건을 읽고 정리했습니다.
어디서 등록하나
관리자 콘솔의 결제 설정 > 결제 키 및 보안 메뉴에 IP 보안 탭이 있습니다. 여기에 REST API를 호출하는 서버의 공인 IP를 넣습니다.
자주 막히는 지점
- 로컬 개발 중이라 127.0.0.1을 등록했습니다. 부트페이가 보는 것은 요청이 나온 공인 IP입니다.
- 서버를 늘렸는데 새 인스턴스의 IP를 안 넣었습니다. 오토스케일 환경이면 NAT 게이트웨이의 고정 IP를 등록합니다.
- 개발 서버와 운영 서버가 다른 프로젝트를 쓰는데 한쪽에만 등록했습니다.
기준입니다. 같은 코드라도 PG 와 계약 상태에 따라 응답 문구가 달라질 수 있습니다. 응답 본문 전체를 함께 확인하세요.