Skip to main content
Webhook Cover Image
Webhooks는 Dodo Payments 계정에서 특정 이벤트가 발생할 때 실시간 알림을 제공합니다. Webhooks를 사용하여 워크플로를 자동화하고, 데이터베이스를 업데이트하고, 알림을 전송하며, 시스템을 동기화된 상태로 유지할 수 있습니다.
당사의 webhook 구현은 Standard Webhooks 사양을 따르므로 업계 모범 사례 및 기존 webhook 라이브러리와의 호환성을 보장합니다.

주요 기능

Real-time Delivery

이벤트가 발생하면 즉시 알림 수신

Secure by Default

HMAC SHA256 서명 검증 포함

Automatic Retries

지수 백오프를 적용한 기본 재시도 로직

Event Filtering

필요한 이벤트만 구독

시작하기

Dodo Payments 웹훅 포털이 네이티브 대시보드 환경으로 새롭게 구축되었습니다. 기존 엔드포인트, signing secret, signature verification, 이벤트 이름 및 webhook payload는 변경되지 않았습니다. 통합 작업은 필요하지 않습니다.
각 기능의 위치.
  • Developer → Webhooks 아래Endpoints, Event catalog, Logs, Activity, Settings
  • 개별 엔드포인트에서 — delivery 통계, signing secret 및 Replay history가 표시되는 Overview 탭과 Testing, Advanced 탭 및 일괄 재생 작업
  • 메시지에서Logs 탭에서 열 수 있으며, 엔드포인트를 열지 않고도 각 delivery attempt를 개별적으로 재생할 수 있습니다.
1

Access Webhook Settings

Dodo Payments Dashboard로 이동한 다음 Developer → Webhooks로 이동합니다.
2

Create Webhook Endpoint

Add endpoint를 클릭하여 엔드포인트 생성 side sheet를 엽니다.
3

Enter Endpoint URL or Choose Integration

webhook 이벤트를 수신할 URL을 입력하거나 integration connector를 선택하여 이벤트를 타사 서비스(Slack, Discord, Zapier, Resend 등)로 라우팅합니다.
4

Select Events to Receive

엔드포인트가 수신할 특정 이벤트를 선택합니다. 이벤트는 리소스별로 그룹화된 검색 가능한 트리로 구성됩니다. 개별 이벤트를 선택하거나 상위 리소스를 선택하여 관련된 모든 이벤트를 수신할 수 있습니다.
선택한 이벤트만 엔드포인트로 webhook을 트리거하므로 불필요한 트래픽과 처리를 줄일 수 있습니다.
5

Create Endpoint

Create endpoint를 클릭하여 구성을 저장합니다.
6

Get Secret Key

webhook signing secret은 엔드포인트의 Overview 탭에 표시됩니다. 수신한 webhook의 진위를 확인할 때 사용합니다.
webhook secret key를 안전하게 보관하고 클라이언트 측 코드나 공개 repository에 절대 노출하지 마세요.
7

Rotate Secret (Optional)

보안을 강화해야 하는 경우 webhook secret을 교체할 수 있습니다. Overview 탭에서 secret 옆의 Rotate secret을 클릭합니다.
secret을 교체하면 기존 secret이 만료되고 새 secret으로 대체됩니다. 이전 secret은 다음 24시간 동안만 유효합니다. 이후 이전 secret으로 verification을 시도하면 실패합니다.
secret이 유출되었다고 의심되는 경우 또는 정기적으로 secret rotation을 사용하세요.

Integration Connectors

직접 webhook receiver를 구축하는 대신 integration connector를 사용하여 webhook 이벤트를 타사 서비스로 바로 라우팅할 수 있습니다. 이를 통해 널리 사용되는 플랫폼을 위한 custom webhook handler를 작성하고 유지 관리할 필요가 없습니다.

Connector 작동 방식

connector는 Dodo Payments 이벤트를 대상 서비스가 요구하는 형식으로 변환합니다. 제공해야 하는 세부 정보는 대상에 따라 다릅니다. 대시보드의 connector picker에는 현재 비즈니스에서 이용할 수 있는 전체 목록이 표시됩니다. 따라서 위 표는 전체 목록이 아니라 단계별 설정 안내가 제공되는 대상 목록으로 참고하세요. 이벤트가 각 대상에 도달한 후 수행할 수 있는 작업은 External Integrations을 참조하세요.

Connector 설정

엔드포인트를 생성하거나 편집할 때 connector를 선택하면 side sheet에 해당 대상에 맞는 설정 안내가 표시됩니다. 예를 들어 Slack에서 incoming webhook URL을 생성하는 방법이나 Resend API key를 찾는 위치가 안내됩니다. 저장하기 전에 connector transformation test를 실행하여 이벤트가 대상에 맞게 올바르게 변환되는지 확인하세요.
코드를 작성하지 않고 지원되는 대상에 연결하려면 connector를 사용하세요. custom logic이 필요한 경우에는 대신 transformation이 적용된 standard endpoint를 사용하세요.

구독 이벤트 구성

각 webhook endpoint가 수신할 특정 이벤트를 구성할 수 있습니다.
1

Navigate to Webhook Endpoints

Dodo Payments Dashboard로 이동한 다음 Developer → Webhooks로 이동합니다.
2

Select Your Endpoint

구성할 webhook endpoint를 클릭합니다.
3

Open Event Configuration

Edit를 클릭하여 endpoint configuration side sheet를 엽니다.
4

Browse Event Types

event type selector에는 리소스별로 그룹화된 검색 가능한 트리 형태로 사용 가능한 모든 webhook 이벤트가 표시됩니다(예: payment, subscription, dispute). 검색창을 사용하면 이름이나 keyword로 특정 이벤트를 빠르게 찾을 수 있습니다.
5

Select Events

수신할 이벤트 옆의 checkbox를 선택합니다. 다음과 같이 할 수 있습니다.
  • 개별 이벤트 선택(예: payment.succeeded, payment.failed)
  • 상위 리소스를 선택하여 관련된 모든 이벤트 수신
  • 필요에 따라 특정 이벤트 조합
6

Save Configuration

Save를 클릭하여 변경 사항을 적용하거나 Cancel을 클릭하여 수정 사항을 취소합니다.
모든 이벤트를 선택 해제하면 webhook endpoint는 어떤 notification도 수신하지 않습니다. 애플리케이션이 정상적으로 작동하는 데 필요한 이벤트를 하나 이상 선택하세요.

이벤트 카탈로그

Developer → Webhooks로 이동하여 Event catalog 탭을 엽니다. 이 탭에는 Dodo Payments가 전송할 수 있는 모든 이벤트 유형이 표시되므로 endpoint를 구독하기 전에 사용 가능한 이벤트를 확인할 수 있습니다. 이벤트를 선택하면 schema와 example payload를 볼 수 있으며, 읽으려는 field의 형식을 확인하는 가장 빠른 방법입니다.

Webhook Events Guide

동일한 이벤트를 리소스별로 그룹화된 reference documentation으로 찾아볼 수 있습니다.

Webhook Delivery

Timeout

webhook에는 connection 및 read operation 모두에 대해 15초 timeout window가 적용됩니다. timeout을 방지하려면 endpoint가 빠르게 응답하도록 하세요.
webhook은 수신 즉시 200 status code로 수신을 확인한 후, 실제 처리는 background에서 수행하는 비동기 방식으로 처리하세요.

Automatic Retries

webhook delivery가 실패하면 Dodo Payments는 시스템에 과부하가 발생하지 않도록 exponential backoff를 사용해 자동으로 retry합니다.
webhook event당 retry는 최대 8회입니다. 예를 들어 webhook이 성공하기 전에 세 번 실패하면 첫 번째 attempt부터 전체 delivery 시간은 약 35분 5초입니다.
Dodo Payments dashboard에서 언제든 개별 message를 수동으로 retry하거나 실패한 모든 message를 일괄 복구할 수 있습니다.

Idempotency

각 webhook event에는 고유한 webhook-id header가 포함됩니다. 이 identifier를 사용하여 idempotency를 구현하고 중복 처리를 방지하세요.
idempotency check를 항상 구현하세요. retry로 인해 동일한 event를 여러 번 수신할 수 있습니다.

Event Ordering

retry 또는 network condition으로 인해 webhook event가 순서대로 도착하지 않을 수 있습니다. 어떤 순서로든 event를 처리할 수 있도록 시스템을 설계하세요.
webhook event가 처음 생성된 시점과 관계없이 delivery 시점의 최신 payload를 수신합니다.

Webhook 보안

webhook의 보안을 유지하려면 항상 payload를 validate하고 HTTPS를 사용하세요.

Signature 확인

각 webhook request에는 webhook-signature header가 포함됩니다. 이 header는 secret key로 서명된 webhook payload와 timestamp의 HMAC SHA256 signature입니다.

SDK verification (권장)

모든 공식 SDK에는 수신한 webhook을 안전하게 validate하고 parse할 수 있는 built-in helper가 포함되어 있습니다. 다음 두 가지 method를 사용할 수 있습니다.
  • unwrap(): webhook secret key를 사용하여 signature를 verify합니다
  • unsafe_unwrap(): verification 없이 payload를 parse합니다
Dodo Payments client를 초기화할 때 DODO_PAYMENTS_WEBHOOK_KEY를 통해 webhook secret을 제공합니다.

Manual verification (대안)

SDK를 사용하지 않는 경우 Standard Webhooks spec에 따라 직접 signature를 verify할 수 있습니다.
  1. webhook-id, webhook-timestamp 및 정확한 raw stringified payload를 마침표( .)로 구분하여 연결해 signed message를 구성합니다.
  2. Dashboard의 webhook secret key를 사용하여 해당 문자열의 HMAC SHA256을 계산합니다.
  3. 계산한 signature를 webhook-signature header와 비교합니다. 일치하면 webhook은 authentic합니다.
Standard Webhooks specification을 따릅니다. signature verification에는 해당 library를 사용할 수 있습니다: https://github.com/standard-webhooks/standard-webhooks/tree/main/libraries. event payload format은 Webhook Payload을 참조하세요.

소스 IP 주소

웹훅을 인증하는 데 지원되는 방법은 서명 검증입니다. 이를 통해 요청이 웹훅 시크릿으로 서명되었음을 증명할 수 있지만, 네트워크 수준의 확인만으로는 이를 검증할 수 없습니다. 웹훅 전송은 전송 인프라에 속한 소스 IP 주소 풀에서 이루어집니다. 이 풀은 수시로 변경되므로 해당 주소를 통합의 고정된 속성이 아닌 운영상의 세부 정보로 취급하세요.
소스 IP allowlist를 인증 메커니즘으로 사용하지 마세요. Allowlist는 요청이 어디에서 왔는지만 보여 줄 뿐, 해당 요청이 진짜이거나 변조되지 않았음을 보여 주지는 않습니다. 서명 검증에 설명된 대로 모든 요청에서 webhook-signature 헤더를 검증하세요.
인프라가 명시적인 allowlist를 요구하는 방화벽 뒤에 있는 경우 다음 사항에 유의하세요:
  • 주소를 영구적으로 하드코딩하지 마세요. 범위는 시간이 지나면서 추가되고 폐기되며, 오래된 규칙은 전송을 조용히 차단합니다.
  • 방화벽을 제한하기 전에 support@dodopayments.com에서 현재 범위를 요청하여 최신 목록을 사용하세요.
  • 변경 알림을 확인하세요. 전송 주소가 변경되면 영향을 받는 merchant에게 이메일로 알립니다. 전송이 누락되지 않도록 지정된 날짜 전에 해당 업데이트를 적용하세요.
  • 추가하는 네트워크 규칙과 관계없이 서명 검증을 활성화된 상태로 유지하세요.
서버리스 및 관리형 호스팅 플랫폼에서는 인바운드 IP 필터링을 사용할 수 없거나 유지 관리가 비현실적인 경우가 많습니다. 이러한 환경에서는 서명 검증이 올바른 제어 수단이며 allowlist가 필요하지 않습니다.
차단된 전송은 다른 모든 실패와 동일하게 처리되며 자동 재시도에 설명된 일정에 따라 재시도됩니다. 방화벽 규칙으로 인해 전송이 실패한 경우 규칙을 수정한 후 다시 전송할 수 있습니다. 자세한 내용은 메시지 재생 및 복구를 참조하세요.

웹훅에 응답하기

  • 웹훅 핸들러는 이벤트 수신을 확인하기 위해 2xx status code를 반환해야 합니다.
  • 다른 응답은 모두 실패로 처리되며 웹훅이 재시도됩니다.

모범 사례

웹훅 엔드포인트에는 항상 HTTPS URL을 사용하세요. HTTP 엔드포인트는 중간자 공격에 취약하며 웹훅 데이터를 노출합니다.
웹훅을 수신하는 즉시 200 상태 코드를 반환하세요. 시간 초과를 방지하려면 이벤트를 비동기적으로 처리하세요.
webhook-id 헤더를 사용하여 멱등성을 구현하면 동일한 이벤트가 여러 번 처리되어도 부작용 없이 안전하게 처리할 수 있습니다.
환경 변수 또는 시크릿 관리자를 사용하여 웹훅 시크릿을 안전하게 저장하세요. 시크릿을 버전 관리 시스템에 절대 커밋하지 마세요.

웹훅 페이로드 구조

웹훅 페이로드 구조를 이해하면 이벤트를 올바르게 파싱하고 처리하는 데 도움이 됩니다.

요청 형식

헤더

string
필수
이 웹훅 이벤트의 고유 식별자입니다. 멱등성 확인에 사용하세요.
string
필수
웹훅의 진위를 검증하기 위한 HMAC SHA256 서명입니다.
string
필수
웹훅이 전송된 시점의 Unix 타임스탬프(초 단위)입니다.

요청 본문

string
필수
Dodo Payments 비즈니스 식별자입니다.
string
필수
이 웹훅을 트리거한 이벤트 유형입니다(예: payment.succeeded, subscription.active).
string
필수
이벤트가 발생한 시점의 ISO 8601 형식 타임스탬프입니다.
object
필수
이벤트에 관한 상세 정보를 포함하는 이벤트별 페이로드입니다.

페이로드 예시

Event Types

사용 가능한 모든 웹훅 이벤트 유형 탐색

Event Payloads

각 이벤트의 상세 페이로드 스키마 보기

Handle Payment Failures

payment.failed에 대응하고 거부된 결제를 복구

웹훅 테스트

실행 환경으로 전환하기 전에 Dodo Payments 대시보드에서 직접 웹훅 통합을 테스트하여 엔드포인트가 올바르게 작동하는지 확인할 수 있습니다.
1

Navigate to Webhooks

Dodo Payments Dashboard로 이동한 후 Developer → Webhooks로 이동하세요.
2

Select Your Endpoint

웹훅 엔드포인트를 클릭하여 세부 정보 페이지에 액세스하세요.
3

Open Testing Tab

Testing 탭을 클릭하여 웹훅 테스트 인터페이스에 액세스하세요.

예시 이벤트 전송

Testing 탭은 수신기를 확인할 수 있도록 이 엔드포인트에 샘플 페이로드를 전송합니다.
1

Select Event Type

Select an event type를 사용하여 테스트할 이벤트를 선택하세요(예: payment.succeeded 또는 payment.failed).
2

Send Example

Send example을 클릭하세요. 샘플 페이로드가 실제 이벤트와 동일한 방식으로 서명되어 엔드포인트 URL로 전송됩니다.
Testing 탭에서 전송된 실패 메시지는 재시도되지 않습니다. 재시도 일정을 테스트하는 것이 아니라 수신기를 확인하는 데 사용하세요.
3

Check Your Endpoint

탭에는 Last example sent가 전송된 시간이 기록됩니다. 이벤트가 도착했는지, 서명 검증이 통과했는지, 2xx 상태 코드를 반환했는지 확인하세요.

구현 예시

다음은 웹훅 검증 및 처리를 보여 주는 완전한 Express.js 구현 예시입니다:
프로덕션 이벤트를 처리하기 전에 대시보드 테스트 인터페이스를 사용하여 웹훅 핸들러를 철저히 테스트하세요. 이를 통해 문제를 조기에 식별하고 해결할 수 있습니다.

CLI로 웹훅 테스트

Dodo Payments CLI는 터미널을 벗어나지 않고 로컬 개발 중 웹훅을 테스트할 수 있는 두 가지 명령을 제공합니다.

로컬에서 실시간 웹훅 수신

테스트 모드 계정의 실제 웹훅 이벤트를 로컬 개발 서버로 실시간 전달하세요:
CLI는 Dodo Payments에 WebSocket 연결을 열고 모든 웹훅 이벤트를 로컬 엔드포인트(예: http://localhost:3000/webhook)로 전달합니다. 검증 테스트를 위해 서명 헤더를 포함한 모든 헤더가 그대로 유지됩니다.
리스너는 test mode API 키에서만 작동합니다. 이 명령을 사용하기 전에 dodo login를 실행하고 Test Mode를 선택하세요.

모의 웹훅 이벤트 트리거

실제 거래를 생성하지 않고 모든 엔드포인트에 모의 웹훅 페이로드를 전송하세요:
이 대화형 도구를 사용하면 이벤트 유형을 선택하고 사실적인 모의 페이로드를 엔드포인트로 전송할 수 있습니다. 세션 하나에서 여러 이벤트를 테스트할 수 있도록 반복 실행됩니다. 트리거 명령은 Dodo Payments가 전송하는 47가지 이벤트 유형을 모두 지원합니다. 여기에는 구독, 결제, 환불, 분쟁, 라이선스 키, 지급, 크레딧, 중단된 checkout, 독촉 및 entitlement grant 계열이 포함됩니다. 정확한 목록은 Supported Webhook Events를 참조하세요.
dodo wh trigger에서 생성된 모의 웹훅 페이로드에는 서명이 없습니다. 테스트 중에만 웹훅 핸들러에서 unwrap() 대신 unsafe_unwrap()를 사용하세요.

CLI Webhook Testing Docs

전체 CLI 웹훅 테스트 문서 보기

고급 설정

Advanced 탭에서는 웹훅 엔드포인트 동작을 세밀하게 조정할 수 있는 추가 구성 옵션을 제공합니다.

Rate Limiting(Throttling)

시스템에 과부하가 발생하지 않도록 웹훅 이벤트가 엔드포인트로 전달되는 속도를 제어하세요.
1

Open Advanced Tab

엔드포인트 세부 정보 페이지에서 Advanced 탭을 클릭하세요.
2

Configure Rate Limit

“Rate Limit (throttling)” 섹션에서 Edit를 클릭하여 rate limit 설정을 수정하세요.
기본적으로 웹훅에는 rate limit이 적용되지 않으므로 이벤트가 발생하는 즉시 전달됩니다.
3

Set Your Limit

원하는 rate limit을 구성하여 웹훅 전달 빈도를 제어하고 시스템 과부하를 방지하세요.
웹훅 핸들러가 이벤트를 처리할 시간을 확보해야 하거나 여러 이벤트를 함께 일괄 처리하려는 경우 rate limiting을 사용하세요.

사용자 지정 헤더

엔드포인트로 전송되는 모든 웹훅 요청에 사용자 지정 HTTP 헤더를 추가하세요. 인증, 라우팅 또는 메타데이터 추가에 유용합니다.
1

Add Headers

“Custom Headers” 섹션에서 각 사용자 지정 헤더의 KeyValue를 입력하세요.
2

Add Multiple Headers

필요에 따라 + 버튼을 클릭하여 사용자 지정 헤더를 추가하세요.
사용자 지정 헤더는 이 엔드포인트로 전송되는 모든 웹훅 요청에 포함됩니다.

변환

변환을 사용하면 웹훅의 페이로드를 수정하고 필요한 경우 다른 URL로 리디렉션할 수 있습니다. 이 강력한 기능을 사용하면 다음 작업을 수행할 수 있습니다:
  • 처리 전에 페이로드 구조 수정
  • 콘텐츠에 따라 웹훅을 다른 엔드포인트로 라우팅
  • 페이로드에서 필드 추가 또는 제거
  • 데이터 형식 변환
1

Enable Transformations

Enabled 스위치를 전환하여 변환 기능을 활성화하세요.
2

Configure Transformation

Edit transformation을 클릭하여 JavaScript로 변환 규칙을 정의하세요.
3

Test Transformation

실행 환경으로 전환하기 전에 변환 테스트 인터페이스를 사용하여 변환이 올바르게 작동하는지 확인하세요.
변환은 웹훅 전달 성능에 영향을 줄 수 있습니다. 충분히 테스트하고 변환 로직을 단순하고 효율적으로 유지하세요.
변환은 특히 다음 작업에 유용합니다:
  • 서로 다른 데이터 형식 간 변환
  • 특정 기준에 따른 이벤트 필터링
  • 페이로드에 계산된 필드 추가
  • 이벤트를 다른 마이크로서비스로 라우팅

웹훅 로그 모니터링

Logs 탭에서는 웹훅 전달 상태를 종합적으로 확인할 수 있어 웹훅 이벤트를 효과적으로 모니터링하고 디버깅하며 관리할 수 있습니다.
1

Navigate to Logs Tab

Developer → Webhooks로 이동하여 Logs 탭을 여세요.
2

Browse Delivery History

Event type, Message ID, Event ID, Sent at, Attempted at, Response code 및 Duration 열이 있는 모든 웹훅 전송 시도 표를 확인하세요.
3

Search and Filter

검색창을 사용하여 ID 또는 이벤트 유형으로 특정 메시지를 찾으세요. 상태(Succeeded, Failed, Pending 등)로 필터링하여 조사해야 하는 이벤트에 집중할 수 있습니다.
4

View Message Details

메시지를 클릭하여 다음 내용을 보여 주는 메시지 세부 정보 페이지를 여세요:
  • 전체 웹훅 페이로드
  • 응답 코드 및 기간이 포함된 모든 전송 시도
  • 각 시도의 타임스탬프
  • 엔드포인트에서 반환된 오류 메시지
각 시도에는 Replay 작업이 있어 페이지를 벗어나지 않고 해당 메시지 하나를 다시 전송할 수 있습니다.

활동 모니터링

Developer → Webhooks로 이동하여 Activity 탭을 열면 엔드포인트 전반의 전달 성능을 확인할 수 있습니다. Delivery activity는 시간에 따른 시도를 표시하며, 기간에 따라 Attempts per 5 minutes, Attempts per hour 또는 Attempts per day 단위로 그룹화됩니다. 각 막대는 결과별로 나뉘며, 세그먼트에 마우스를 올리면 상태, 시도 횟수 및 전체에서 차지하는 비율이 표시됩니다. 엔드포인트의 Overview 탭에 있는 **Delivery stats (last 24h)**에서는 지난 하루 동안의 동일한 정보를 요약합니다.
Endpoints 탭의 Error rate (24h) 열에서는 엔드포인트를 열어 보기 전에 어떤 엔드포인트에 주의가 필요한지 한눈에 확인할 수 있습니다.

메시지 재생 및 복구

메시지를 다시 전송하는 방법은 필요한 메시지 수에 따라 달라집니다:
  • 메시지 하나Logs 탭에서 메시지를 열고 시도 항목의 Replay 작업을 사용하세요. 엔드포인트를 열 필요가 없습니다.
  • 메시지 범위 — 일괄 모드는 한 번에 하나의 엔드포인트에만 적용되므로 엔드포인트를 여세요.

일괄 재생

Developer → Webhooks에서 엔드포인트를 여세요. 세 가지 모드를 사용할 수 있으며, 각 모드는 해당 엔드포인트에만 적용됩니다. 설정하는 범위는 모드에 따라 다릅니다:
1

Open More Actions

엔드포인트에서 More actions를 열고 위의 세 가지 모드 중 하나를 선택하세요.
2

Set the Range

표에 나열된 대로 해당 모드에서 요청하는 범위를 입력하세요.
3

Start the Run

선택한 모드에 따라 Recover 또는 Replay를 클릭하세요.
각 실행은 엔드포인트의 Overview 탭에 있는 Replay history 아래에 표시되며, 모드, 시간 범위, 상태 및 다시 전송된 메시지 수가 함께 표시됩니다.

이메일 알림

엔드포인트로의 웹훅 전달이 실패할 때 이메일 알림을 받아 문제가 누적되기 전에 해결하세요.
1

Navigate to Settings Tab

Developer → Webhooks로 이동하여 Settings 탭을 여세요.
2

Find Email Alerting

Email alerting 카드를 찾으세요.
3

Configure Email Addresses

알림을 받을 주소를 입력하세요. 여러 주소는 쉼표로 구분하고, 알림을 끄려면 필드를 비워 두세요.
4

Save

Save를 클릭하여 변경 사항을 적용하세요.
이메일 알림을 활성화하여 웹훅 전달 문제를 조기에 파악하고 안정적인 통합을 유지하세요.

클라우드 플랫폼에 배포

웹훅 핸들러를 프로덕션에 배포할 준비가 되셨나요? 각 플랫폼의 모범 사례와 함께 인기 클라우드 제공업체에 웹훅을 배포하는 데 도움이 되는 플랫폼별 가이드를 제공합니다.

Vercel

서버리스 함수로 Vercel에 웹훅 배포

Cloudflare Workers

Cloudflare의 엣지 네트워크에서 웹훅 실행

Supabase Edge Functions

Supabase와 웹훅 통합

Netlify Functions

Netlify 서버리스 함수로 웹훅 배포
각 플랫폼 가이드에는 해당 제공업체에 맞는 환경 설정, 서명 검증 및 배포 단계가 포함되어 있습니다.

관련 API 레퍼런스

Create Webhook

웹훅 엔드포인트를 프로그래밍 방식으로 생성하고 구성하기 위한 API 레퍼런스

List Webhooks

웹훅 엔드포인트를 조회하고 관리하기 위한 API 레퍼런스
마지막 수정일 2026년 8월 21일