안녕하세요 웹훅 테스트 환경 등록 관련 에러 발생하여 문의드립니다.
문제 상황
- 개발자 대시보드에서 웹훅 엔드포인트 추가 시도 시 실패
- UI 메시지: "에러가 발생하였습니다. 잠시 후 다시 시도해주세요"
- 콘솔 에러: 500 Internal Server Error
환경 정보
- 위치: 개발자 대시보드 > 웹훅 관리
- 환경: 테스트(test) 환경
- 발생 시간: [2025-09-18 2:21 PM]
- 브라우저: [Chrome]
에러 상세
- API Endpoint: /developers/api/v1/webhook/endpoints
- HTTP Status: 500
- Error Type: TossPaymentsError
15 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
엔드포인트가 귀사 서버인가요?
웹훅 테스트는 실제 웹훅을 보내기전에 웹훅 샘플데이터 긁어서 postman 으로 먼저 확인하시는게 좋습니다
웹훅 받는 full url 이 등록이 안되는 상태인가요?
네 그렇습니다
endpoints는 TossPayments 서버입니다
여기에 등록이 안된다는건가요?
네
여기는 토스페이먼츠 URL 을 넣는곳이 아니구요
직접 운영중이신 서버의 URL 을 넣어야해요
웹훅을 받으시는거라서 여기에 등록하면 토스페이먼츠가 보내주게됩니다
웹훅(Webhook) 연결하기 | 토스페이먼츠 개발자센터
토스페이먼츠 결제, 브랜드페이, 지급대행 상태에 변경사항이 있을 때 웹훅으로 실시간 업데이트를 받아보세요.
저기 에러 코드는 콘솔에서 확인한 걸 보내드린거에요
제가 웹훅을 받을 url 입력시 저렇게 나오며 등록이 안됩니다. 따로 에러 메세지가 자세하지 않아서 어떤 이유인지 몰라서 문의드려요
url 전달주세요
개발자센터 로그인은 잘 되고있는거죠?
네 잘됩니다.
https://helperai.dev/webhook-tosspayment 로 받으려고 하고 있습니다.
이건 helperai.dev 도메인을 로컬(127.0.0.1)로 향해있는 도메인을 알아서 이걸 로컬 개발 서버를 실제 도메인처럼 사용하고 있습니다
이런 경우엔 등록이 안되는 걸까요?
DNS over Discord: A records
helperai.dev A @1.1.1.1 +noall +answer +short +cdflag
:warning: cd bit set, DNSSEC validation disableddiggy diggy hole
이러면 웹훅 호출이 실패하기 때문에 등록이 안됩니다.
외부 접속이 가능하도록 설정해 주시기 바랍니다.
아 맞네요.. 그러네요 감사합니다.
외부 도메인작업이 안된상태라면 공인아이피로 등록을 먼저 해서 테스트 해보시고 진행하시면 쉽게될거에요
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.