Webhook Payloads
Recovery
장바구니 복구 또는 구독 경고 이벤트가 발생할 때 웹훅 엔드포인트에 전송되는 페이로드입니다.
장바구니 복구 이벤트
다음 웹훅 이벤트는 장바구니 복구 수명 주기를 추적합니다:방치된 결제 페이로드 필드
checkout이 중단된 이유입니다. 다음 중 하나입니다:
payment_failed— 고객이 결제를 시도했지만 실패함checkout_incomplete— 고객이 checkout을 방문했지만 결제를 시도하지 않음
이 복구 시도의 현재 lifecycle 상태입니다. 다음 중 하나입니다:
abandoned— 감지됨, 아직 이메일이 전송되지 않음recovering— 하나 이상의 복구 이메일이 전송됨recovered— 고객이 결제를 완료함exhausted— 모든 이메일이 전송되었거나 더 최근의 checkout이 발견됨opted_out— 고객이 구독을 취소함
예시: ACR Webhook 처리
Dunning 이벤트
다음 webhook 이벤트는 subscription dunning lifecycle을 추적합니다:Dunning Attempt Payload Fields
연체 관리(dunning)를 트리거한 구독 상태입니다. 다음 중 하나입니다:
on_hold— 결제 실패로 인해 갱신이 중지됨past_due— 유예 기간이 열려 있는 동안 갱신에 실패함cancelled— 고객이 Customer Portal에서 취소함
이 dunning 시도의 현재 lifecycle 상태입니다. 다음 중 하나입니다:
recovering— dunning 이메일이 전송 중임recovered— 고객이 payment method를 업데이트했고 결제가 성공함exhausted— 모든 이메일이 전송되었거나 subscription 상태가 변경됨
예시: Dunning Webhook 처리
Abandoned Cart Recovery
ACR 이메일 sequence 및 discount incentive를 구성합니다.
Subscription Dunning
만료된 subscription에 대한 dunning 이메일 sequence를 구성합니다.
Subscription Webhooks
subscription.on_hold 및 subscription.cancelled와 같은 관련 subscription lifecycle 이벤트입니다.Webhook Payload Schema
아래 스키마는 중단된 checkout 페이로드(AbandonedCheckoutPayload)입니다. dunning 페이로드 필드는 Dunning Attempt Payload Fields를 참조하세요.Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events
마지막 수정일 2026년 9월 26일