Stripe 웹훅 'Timestamp out of tolerance' 오류, NTP 서버 동기화 방법 문의

안녕하세요 Jung Ji Soo

해당 오류는 Stripe 웹훅 서명 검증 시 서버 시간과 Stripe 서버 시간 간의 차이가 허용 범위(기본 5분)를 초과할 때 주로 발생합니다. 백엔드 애플리케이션 자체보다는 실제 애플리케이션이 실행 중인 호스트 OS의 시간 동기화 상태를 먼저 확인해 보시는 것을 권장드립니다.

만약 Linux 서버를 사용 중이시라면 먼저 timedatectl status 명령으로 NTP 동기화 상태를 확인해 보세요. System clock synchronized: yes 와 NTP service: active 로 표시되어야 정상입니다. 동기화가 비활성화된 경우 sudo timedatectl set-ntp true 명령을 실행한 후 몇 분 정도 지나서 다시 상태를 확인해 보시면 됩니다. 또한 chronyd 또는 systemd-timesyncd 서비스가 실행 중인지 확인하고, 필요 시 서비스를 재시작하여 강제 동기화를 시도할 수 있습니다. 동기화 이후에는 서버 시간과 UTC 시간이 정확한지 확인한 뒤 Stripe 웹훅 검증을 다시 테스트해 보시는 것을 추천드립니다.

위 조치 후에도 동일한 문제가 발생한다면 사용 중인 운영체제 버전과 NTP 구성 정보를 공유해 주시면 추가로 확인해 드리겠습니다. 도움이 되셨다면 "Accept Answer"를 눌러 주시면 감사하겠습니다.