들어가며: 웹훅이 죽어도 아무도 모르는 무서운 밤
조용히 증발하는 매출 데이터의 현실
지난 주말 밤, 결제 대행사 웹훅이 조용히 죽었다. 나는 그 사실을 모른 채 잠들었고, 월요일 아침에 대시보드 숫자가 안 맞는 걸 보고서야 알아챘다. 매출 데이터가 유실된 거다. 1인 빌더가 혼자 서비스를 굴리면 이런 일이 빈번하다. 아무도 알려주지 않는다.
1인 빌더가 겪는 파이프라인 다운의 공포
파이프라인이 중간에 끊기면, 앞단에서는 결제가 성공했는데 뒷단에서는 데이터가 안 들어오는 불상사가 벌어진다. 고객은 돈을 냈는데 서비스는 안 열려 있다. 이걸 사람이 일일이 확인하기엔 너무 피곤하다. 그래서 웹훅 실패를 자동으로 감지하고 복구하는 시스템을 Pipedeck에 구축했다.
웹훅 실패를 자동으로 감지하고 재시도를 거는 방법
상태 코드(4xx vs 5xx)에 따른 재시도 분기 처리
웹훅이 실패했다고 무조건 재시도를 걸면 안 된다. 404나 400 같은 4xx 에러는 요청 자체가 잘못된 거라서 재시도를 백 번 해도 똑같이 실패한다. 500 에러나 타임아웃일 때만 재시도를 걸어야 한다.
Make나 Zapier 같은 자동화 툴에서 에러 라우팅을 설정할 때 이걸 명확히 분기한다.
- HTTP 상태코드가 4xx면 에러 로그만 남기고 플로우를 종료한다.
- 5xx거나 타임아웃이면 재시도 큐로 보낸다.
자동화 툴에서 재시도 트리거 자동 설정하기
자동화 툴에서 HTTP 모듈의 응답 코드를 확인하고, 200번대가 아니면 바로 재시도 라우터로 연결되게 설계한다. 이 구조가 없으면 실패한 웹훅은 그냥 블랙홀에 빠져서 영영 사라진다.

몇 회까지 재시도할까? 무한 루프 비용 폭발 막기
실전 운영 기준: 최대 5회와 지수 백오프
재시도를 무한으로 돌리면 타겟 서버가 죽었을 때 내 자동화 툴의 테스크가 계속 쌓이면서 비용이 폭발한다. 1인 기업은 여기서 비용 통제가 생명이다.
나는 최대 5회까지만 재시도를 건다. 그리고 바로 시도하지 않고 시간 간격을 늘린다. 1분, 5분, 15분, 60분, 180분 식으로 기하급수적으로 늘리는 지수 백오프 방식을 쓴다. 서버가 일시적으로 힘들어하고 있을 때 쉴 틈을 주는 셈이다.
Dead Letter Queue(DLQ)로 비용 터지는 것 원천 차단
5회 재시도가 전부 실패하면 이 데이터를 Dead Letter Queue(DLQ)로 보낸다. 루프를 완전히 끊어버리는 거다. 실패한 데이터를 별도의 데이터베이스나 스프레드시트에 쌓아두고 자동화 플로우는 종료한다. 이렇게 해야 불필요한 비용이 새어나가지 않는다.

재시도 중 중복 처리 방지: 멱등성 확보 (코드 포함)
멱등성 키(Idempotency Key)의 개념과 필요성
재시도를 하면서 가장 무서운 게 중복 처리다. 결제 웹훅이 타임아웃 났다고 재시도를 걸었는데, 사실 첫 번째 요청이 늦게 도착해서 성공했을 수도 있다. 여기서 두 번째 요청까지 성공 처리하면 고객이 두 번 결제된다.
이걸 막으려면 멱등성이 필요하다. 같은 요청을 여러 번 처리해도 결과가 한 번 처리한 것과 같게 만드는 거다. 웹훅 페이로드에 있는 고유 키를 저장해두고, 재시도 시 이 키가 이미 처리됐는지 확인한다.
중복 결제/이중 처리를 막는 실전 코드
Pipedeck에서 실제로 쓰고 있는 멱등성 검증 로직이다. Node.js로 작성했다.
// 웹훅 페이로드의 고유 ID로 멱등성 검증
const processWebhook = async (payload) => {
const idempotencyKey = payload.event_id;
// 이미 처리된 키인지 확인
const existing = await db.query('SELECT status FROM webhook_log WHERE event_id = $1', [idempotencyKey]);
if (existing && existing.status === 'completed') {
console.log('이미 처리된 웹훅입니다. 스킵합니다.');
return { success: true, message: 'Idempotent request skipped' };
}
try {
await db.query('BEGIN');
await db.query('INSERT INTO webhook_log (event_id, status) VALUES ($1, $2) ON CONFLICT (event_id) DO NOTHING', [idempotencyKey, 'processing']);
// 여기에 실제 비즈니스 로직(결제 처리 등) 실행
await processPayment(payload.data);
await db.query('UPDATE webhook_log SET status = $1 WHERE event_id = $2', ['completed', idempotencyKey]);
await db.query('COMMIT');
return { success: true };
} catch (error) {
await db.query('ROLLBACK');
throw error;
}
};
과거에 중복 결제 사고를 겪고 나서 도입했다. 이 코드 한 장으로 밤에 편하게 잘 수 있게 됐다.
최종 실패했을 때 나한테 즉각 알리는 방법
슬랙/디스코드/텔레그램 연동 알림 템플릿
5회 재시도 끝에 DLQ로 빠진 데이터는 결국 사람이 들여다봐야 한다. 이때 내가 모르고 있으면 답이 없다. 그래서 최종 실패 시점에 텔레그램으로 알림이 오게 해뒀다.
[웹훅 최종 실패 알림] 이벤트 ID: 12345, 사유: 5xx 에러 지속, DLQ 이관 완료. 확인 후 수동 처리 필요.
이 메시지가 폰에 오면 바로 깨어나서 서버 상태를 확인하고 수동으로 처리 여부를 결정한다.
장애 발생 시 1인 빌더의 대응 프로세스
알림을 받으면 가장 먼저 DLQ에 쌓인 데이터를 확인한다. 타겟 서버가 살아났는지 확인하고, 살아났다면 수동으로 웹훅을 다시 트리거하거나 데이터를 직접 입력한다. 자동화 툴에서 수동으로 런 버튼을 누르는 식이다.

결론: 데이터는 증발하지 않게 설계하라
핵심 요약: 감지-제한-중복방지-알림
웹훅 실패를 방치하면 매출은 조용히 사라진다. 내가 쓰는 4단계 방어막은 이렇다.
- 감지: 5xx와 타임아웃을 걸러 재시도 큐로 보낸다.
- 제한: 최대 5회 지수 백오프로 돌리고 DLQ로 루프를 끊는다.
- 중복방지: 멱등성 키로 이중 결제를 막는다.
- 알림: 최종 실패 시 텔레그램 알림으로 바로 깨운다.
다음 스텝: 파이프라인 모니터링 고도화
지금은 알림을 받고 수동 대응하는 구조지만, 이후에는 DLQ에 쌓인 데이터를 특정 시간마다 자동으로 재처리하는 모니터링 로직을 더 얹을 생각이다. 1인 빌더의 무기는 결국 자동화다.
혼자 자동화로 서비스를 굴리는 아일리고입니다. 숏폼 영상은 제가 만든 ClipSquare 로 뽑습니다.
