Skip to main content

GitHub Repository

전체 소스 코드 및 설정 안내

빠른 설정

1. 사전 요구 사항

필요한 항목:

2. 종속성 설치

3. 데이터베이스 설정

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

4. 초기 환경 변수 설정

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

5. 초기화 및 배포

6. 웹훅 URL 확인

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

7. Dodo Payments 대시보드에 웹훅 등록

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

8. 웹훅 키 설정 및 재배포

기능

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

주요 기능

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

구성 파일

데이터베이스 스키마

생성된 테이블:
  • customers — 이메일, 이름 및 Dodo Payments customer ID
  • subscriptions — 상태, 금액, 다음 결제일 및 customer 연결 정보
  • webhook_events — idempotency를 위한 webhook ID가 포함된 이벤트 로그

구현 코드

작동 방식

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

테스트

로컬 개발:
Netlify 대시보드에서 로그 확인:
  1. 사이트를 선택하고 Functions로 이동합니다.
  2. webhook 함수를 클릭합니다.
  3. 실시간 로그와 호출 기록을 확인합니다.
Dodo Payments 대시보드에서 구성:
  1. Developer → Webhooks로 이동합니다.
  2. Netlify Functions URL을 사용하여 엔드포인트를 추가합니다.
  3. subscription.active, subscription.cancelled 및 subscription.renewed을 선택합니다.

일반적인 문제

리소스

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