Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
구독 추심은 결제 실패 또는 고객 취소로 인해 구독이 중단된 고객에게 이메일 시퀀스를 자동으로 전송하여 결제 수단을 업데이트하고 재활성화하도록 요청합니다.
구독 추심이란?
추심은 구독이 복구 가능한 상태에 들어갈 때 자동으로 감지하여 고객이 조치를 취하도록 이메일 시퀀스를 전송합니다:- 보류 중인 구독: 갱신 결제 실패(자금 부족, 카드 만료 등)
- 취소된 구독: 고객 포털에서 고객이 취소
추심 작동 원리
Trigger
추심은 구독이 다음 두 가지 상태 중 하나에 들어갈 때 트리거됩니다:
- 보류 중: 갱신 결제가 실패함 (자금 부족, 카드 만료 등)
- 취소됨: 고객 포털에서 구독을 취소
Email Sequence
트리거 상태에 따라 시스템은 설정된 간격으로 최대 4개의 추심 이메일을 보냅니다. 각 이메일에는 고객 포털로 연결되는 링크가 포함되어 있어 고객이 결제 수단을 업데이트하거나 구독을 다시 구매할 수 있습니다.
상태 수명주기
| 상태 | 설명 |
|---|---|
recovering | 추심 시도가 활성 상태; 이메일이 전송 중 |
recovered | 고객이 결제 수단을 업데이트하고 결제가 성공함 |
exhausted | 복구되지 않거나 구독 상태가 예상치 않게 변경됨 |
추심 시도가
exhausted로 표시되면 구독 상태는 수정되지 않습니다. 구독은 현재 상태(보류 중 또는 취소됨)로 유지됩니다.추심 구성
대시보드의 설정에서 추심을 활성화하고 구성하세요.
이메일 시퀀스
추심은 두 가지 이메일 시퀀스 — 보류 중 및 취소됨 — 각각 최대 4개의 구성 가능한 이메일을 지원합니다. 각 이메일에는 다음과 같은 구성 가능한 필드가 있습니다:| 설정 | 설명 |
|---|---|
| 활성화됨 | 삭제하지 않고 개별 이메일을 켜거나 끕니다 |
| 지연 | 트리거 이벤트 후 해당 이메일 발송까지의 시간 |
| 제목 | 변수 자리 표시자가 포함된 이메일 제목 |
| 본문 | 변수 자리 표시자가 포함된 HTML 이메일 본문 |
| 답장 주소 | 고객의 답장을 위한 이메일 주소 |
| 시퀀스 | 이메일 # | 기본 지연 |
|---|---|---|
| 보류 중 | 1 | 1일 |
| 보류 중 | 2 | 3일 |
| 보류 중 | 3 | 5일 |
| 보류 중 | 4 | 7일 |
| 취소됨 | 1 | 1일 |
| 취소됨 | 2 | 3일 |
| 취소됨 | 3 | 5일 |
| 취소됨 | 4 | 7일 |
추심 이메일 예제
추심은 구독 상태에 따라 다른 이메일을 보냅니다. 아래는 고객이 보는 각 유형의 예시입니다.- On Hold
- Cancelled
고객 복구 경험
고객이 추심 이메일의 링크를 클릭하면 고객 포털로 이동하여 구독 상태를 확인하고 결제 수단을 업데이트할 수 있습니다.
분석
대시보드의 분석 섹션에서 복구 탭을 통해 추심의 성과를 추적하세요.
| 지표 | 설명 |
|---|---|
| 추심 항목 | 생성된 추심 시도의 총 수 |
| 성공률 | 추심 시도가 복구로 이어진 비율 |
| 복구된 수익 | 추심을 통해 복구된 총 수익 |
| 시도별 복구 | 어떤 이메일이 복구를 유도했는지에 대한 분석 |
웹훅 이벤트
| 이벤트 | 설명 |
|---|---|
dunning.started | 특정 구독에 대한 추심 시도가 시작됨 |
dunning.recovered | 추심을 통해 구독이 복구됨 |
Recovery Webhook Payloads
추심 이벤트에 대한 전체 웹훅 페이로드 스키마를 확인하세요.
특수 사례
| 시나리오 | 행동 |
|---|---|
| 이메일 발송 전 고객이 결제 수단을 업데이트 | 복구가 감지됨; 추심 시도가 복구된 것으로 표시됨 |
| 동일한 사업체에서 고객이 다른 구독을 구매 | 추심 시도가 소진된 것으로 표시됨 |
| 모든 추심 이메일 소진됨 | 추심 시도가 소진된 것으로 표시되고, 구독 상태는 수정되지 않음 |
모범 사례
- 기본값으로 시작: 기본 이메일 타이밍은 고객을 과도하게 압박하지 않고 긴급성을 유지하기 위해 합리적인 간격(1, 3, 5, 7일)으로 설계되었습니다.
- 성공률 모니터링: 시퀀스에서 가장 많은 복구를 유도하는 이메일을 추적하세요. 후속 이메일의 전환율이 거의 0에 가까운 경우, 비활성화하는 것을 고려하세요.
- 지원 팀과 협력: 지원 팀이 추심 이메일이 발송되고 있음을 알고 있어, 고객의 문의에 대비할 수 있도록 하세요.
- 구독 상태 검토: 포괄적인 수명주기 추적을 위해
subscription.on_hold및subscription.cancelled웹훅과 함께 추심을 활용하세요.
추심은 기존의 구독 보류 및 고객 포털에서의 재활성화 프로세스와 함께 작동합니다. 활성화되면 추가적인 통합 없이 자동으로 실행됩니다.
관련
Recovery Webhooks
dunning.started 및 dunning.recovered 이벤트에 반응하세요.Abandoned Cart Recovery
대상 이메일을 통해 완료되지 않았거나 실패한 일회성 체크아웃을 복구하세요.
Customer Portal
고객 포털을 통해 고객들이 결제 수단을 업데이트합니다.
Subscriptions
추심 워크플로를 트리거하는 구독 상태를 이해하세요.