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. DodoPayments 대시보드에서 웹훅 등록

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

8. 웹훅 키 설정 및 재배포

기능

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

주요 기능

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

구성 파일

데이터베이스 스키마

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

구현 코드

작동 방식

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

테스트

로컬 개발:
Vercel 대시보드에서 로그 보기:
  1. 프로젝트를 선택합니다.
  2. Deployments → 최신 배포로 이동합니다.
  3. Functions → Logs를 클릭합니다.
Dodo Payments 대시보드에서 구성:
  1. Developer → Webhooks로 이동합니다.
  2. Vercel Functions URL로 엔드포인트를 추가합니다.
  3. subscription.active, subscription.cancelled 및 subscription.renewed를 선택합니다.

일반적인 문제

리소스

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