Skip to main content

GitHub Repository

전체 소스 코드 및 설정 가이드

빠른 설정

1. 사전 요구 사항

필요한 항목:

2. 종속성 설치

3. 데이터베이스 설정

  1. Neon에 가입하고 프로젝트를 생성합니다.
  2. SQL Editor를 엽니다.
  3. schema.sql의 전체 내용을 복사하여 실행합니다.
  4. Connection Details에서 연결 문자열을 복사합니다.

4. 초기 Secret 구성

배포 후 웹훅 URL을 확보하면 DODO_PAYMENTS_WEBHOOK_KEY을 설정합니다.

5. wrangler.toml 업데이트

wrangler.toml을 편집하고 Worker 이름을 설정합니다:

6. 배포

7. 웹훅 URL 가져오기

웹훅 URL은 다음과 같습니다:

8. DodoPayments 대시보드에서 웹훅 등록

  1. Dodo Payments 대시보드에서 Developer → Webhooks로 이동합니다.
  2. Add endpoint를 클릭합니다.
  3. 웹훅 URL을 입력합니다.
  4. 다음 이벤트를 선택합니다: subscription.active, subscription.cancelled, subscription.renewed.
  5. Create endpoint를 클릭하고 signing secret을 복사합니다.

9. 웹훅 Key 설정 및 재배포

수행 작업

웹훅 핸들러는 구독 이벤트를 처리하고 PostgreSQL에 저장합니다:
  • subscription.active — 고객 및 구독 레코드를 생성하거나 업데이트합니다
  • subscription.cancelled — 구독을 취소됨으로 표시합니다
  • subscription.renewed — 다음 결제일을 업데이트합니다

주요 기능

  • 서명 검증 — Dodo Payments SDK를 사용하여 웹훅의 진위성을 검증합니다
  • 멱등성 — 중복 처리를 방지하기 위해 webhook-id 헤더를 사용합니다
  • 이벤트 로깅 — 감사 추적을 위해 모든 이벤트를 webhook_events 테이블에 저장합니다
  • 오류 처리 — 실패를 기록하고 이벤트를 재시도 대상으로 표시합니다
이 예제는 최소한의 필드로 세 가지 핵심 구독 이벤트를 처리합니다. 필요에 따라 추가 이벤트 유형과 필드를 지원하도록 확장할 수 있습니다.

구성 파일

데이터베이스 스키마

생성된 테이블:
  • customers — 이메일, 이름 및 Dodo Payments 고객 ID
  • subscriptions — 상태, 금액, 다음 결제일 및 고객 연결 정보
  • webhook_events — 멱등성을 위한 웹훅 ID가 포함된 이벤트 로그

구현 코드

작동 방식

웹훅 핸들러는 다음 작업을 수행합니다:
  1. 서명을 검증합니다 — Dodo Payments SDK를 사용하여 HMAC-SHA256으로 요청을 검증합니다
  2. 중복을 확인합니다 — 동일한 이벤트가 두 번 처리되지 않도록 webhook-id 헤더를 사용합니다
  3. 이벤트를 기록합니다 — 감사 추적을 위해 원시 웹훅을 webhook_events 테이블에 저장합니다
  4. 이벤트를 처리합니다 — 데이터베이스에서 고객 및 구독을 생성하거나 업데이트합니다
  5. 오류를 처리합니다 — 실패를 기록하고 재시도를 위해 이벤트를 미처리 상태로 표시합니다

테스트

로컬 개발:
Dodo Payments 대시보드에서 구성:
  1. Developer → Webhooks로 이동합니다.
  2. Worker URL을 사용하여 엔드포인트를 추가합니다.
  3. subscription.active, subscription.cancelled 및 subscription.renewed를 선택합니다.

일반적인 문제

리소스

마지막 수정일 2026년 9월 26일