재전송과 멱등성

페이리는 200을 받지 못하면 정해진 간격으로 재전송해요.
그래서 같은 이벤트가 여러 번 도착할 수 있어요.
수신 측은 중복이 와도 한 번만 처리되도록 멱등하게 구현해야 해요.

재시도 규칙

발송은 최대 5회예요.
첫 발송 후 실패하면 아래 간격으로 재시도하고, 5회째도 실패하면 failed로 종료해요.

멱등 처리

재전송된 요청은 본문과 헤더가 처음과 완전히 똑같아요.
특히 webhook-id 헤더는 최초 발송 때 정해져 재전송에도 그대로 유지되므로, 이 값을 멱등 키로 쓰면 돼요.

처리 전에 이 키를 저장소에 기록하고, 이미 있으면 그냥 200만 돌려주세요.

const idempotencyKey = req.get('webhook-id') // msg_... — 재전송에도 동일
 
if (await store.seen(idempotencyKey)) return res.sendStatus(200) // 이미 처리
await store.markSeen(idempotencyKey)
// ... 실제 처리 ...
res.sendStatus(200)