시작하기결제 매뉴얼커머스 매뉴얼

웹훅 이벤트

Commerce API에서 발생하는 모든 이벤트를 실시간으로 수신할 수 있는 웹훅 목록입니다.

총 25개의 웹훅 타입을 지원합니다.

ℹ️
웹훅 수신 시 주의사항
  • idempotency_key 를 사용하여 중복 처리를 방지하세요
  • 웹훅 수신 후 200 응답을 즉시 반환하고, 비즈니스 로직은 비동기로 처리하세요
  • 웹훅 URL은 HTTPS만 지원됩니다
  • 웹훅 설정은웹훅 설정 가이드 를 참고하세요
1
Webhook
웹훅 타입 선택

카테고리와 웹훅 타입을 선택하세요.

2
상세
구독 신청 완료
subscription.requested_done
설명
고객이 구독 상품을 신청하고 결제 수단 등록이 완료되었을 때 전송됩니다. 승인 대기 상태로 시작됩니다.
발송 시점
구독 신청 및 빌링키 발급 완료 시
타입 코드
100
3
공통
공통 필드 (최상위)
▼

모든 웹훅에 공통으로 포함되는 최상위 필드입니다.

파라미터타입필수설명
webhook_typestringY웹훅 이벤트 타입 (예: subscription.approved, order.done)
project_keystringY프로젝트 고유 키
idempotency_keystringY멱등성 키 (중복 처리 방지용 UUID)
payloadobjectY이벤트 상세 데이터
diffobjectN변경 전후 상태 비교 (상태 변경 웹훅에서 포함)
diff.previousobjectN변경 전 상태 값
diff.currentobjectN변경 후 상태 값
카테고리
웹훅 타입
구독 신청 및 빌링키 발급 완료 시
subscription.requested_done
고객이 구독 상품을 신청하고 결제 수단 등록이 완료되었을 때 전송됩니다. 승인 대기 상태로 시작됩니다.