토스페이먼츠 v2 webhook을 Node.js Express로 수신 중인데 5% 정도 요청에서 signature 검증이 실패합니다.
app.post('/webhooks/toss', express.json(), (req, res) => {
const signature = req.headers['x-tosspayments-signature']
const body = JSON.stringify(req.body)
const expected = crypto
.createHmac('sha256', SECRET)
.update(body)
.digest('base64')
if (signature !== expected) {
return res.status(401).send('Invalid signature')
}
// 처리
})
증상
- 대부분 요청 검증 OK
- 약 5% (특히 한글 메모 포함 요청) 검증 실패
- 실패한 요청을 토스 콘솔에서 재시도하면 또 실패
UTF-8 인코딩 문제일까요? 어떻게 처리하시나요?
댓글 4
가장 흔한 함정입니다. express.json()이 body를 파싱한 후 JSON.stringify로 다시 만든 문자열이 원본과 일치하지 않습니다.
토스가 보내는 원본 body가 정확히 다음과 같다고 가정:
express.json()이 받아서 JS 객체로 파싱 → 다시 JSON.stringify하면:
한글이 \u escape로 변환되면 byte 시퀀스 달라져서 signature 다르게 계산됩니다.
해결 — raw body 보존
또는 express.json with verify
Next.js API route라면
5%가 한글 메모 포함된 거 맞으면 위 패턴으로 해결될 겁니다.
저는 토스페이먼츠 + KG이니시스 둘 다 운영하는데 각자 webhook signature 알고리즘이 미세하게 달라요. SDK 직접 작성하지 마시고 가능하면 토스페이먼츠 공식 SDK의 webhook helper 쓰세요.