> ## 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.

# 구독 추심

> 고객에게 결제 수단을 업데이트하도록 요청하여 중단되거나 취소된 구독을 회복하기 위해 자동으로 이메일 시퀀스를 보냅니다.

<Info>
  구독 추심은 결제 실패 또는 고객 취소로 인해 구독이 중단된 고객에게 이메일 시퀀스를 자동으로 전송하여 결제 수단을 업데이트하고 재활성화하도록 요청합니다.
</Info>

## 구독 추심이란?

추심은 구독이 복구 가능한 상태에 들어갈 때 자동으로 감지하여 고객이 조치를 취하도록 이메일 시퀀스를 전송합니다:

* **보류 중인 구독**: 갱신 결제 실패(자금 부족, 카드 만료 등)
* **취소된 구독**: 고객 포털에서 고객이 취소

## 추심 작동 원리

<Steps>
  <Step title="Trigger">
    추심은 구독이 다음 두 가지 상태 중 하나에 들어갈 때 트리거됩니다:

    * **보류 중**: 갱신 결제가 실패함 (자금 부족, 카드 만료 등)
    * **취소됨**: 고객 포털에서 구독을 취소
  </Step>

  <Step title="Email Sequence">
    트리거 상태에 따라 시스템은 설정된 간격으로 최대 4개의 추심 이메일을 보냅니다. 각 이메일에는 고객 포털로 연결되는 링크가 포함되어 있어 고객이 결제 수단을 업데이트하거나 구독을 다시 구매할 수 있습니다.
  </Step>

  <Step title="Recovery">
    고객이 고객 포털을 통해 결제 수단을 업데이트하면 남은 미납 금액에 대해 자동으로 청구가 생성됩니다. 결제가 성공하면 구독이 재활성화되고 추심 시도는 복구된 것으로 표시됩니다.
  </Step>
</Steps>

## 상태 수명주기

| 상태           | 설명                         |
| ------------ | -------------------------- |
| `recovering` | 추심 시도가 활성 상태; 이메일이 전송 중    |
| `recovered`  | 고객이 결제 수단을 업데이트하고 결제가 성공함  |
| `exhausted`  | 복구되지 않거나 구독 상태가 예상치 않게 변경됨 |

<Info>
  추심 시도가 `exhausted`로 표시되면 구독 상태는 수정되지 않습니다. 구독은 현재 상태(보류 중 또는 취소됨)로 유지됩니다.
</Info>

## 추심 구성

대시보드의 **설정**에서 추심을 활성화하고 구성하세요.

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="추심 설정 페이지: 활성화 토글, 1, 3, 5, 7일 간격으로 보류 중인 이메일 및 취소된 이메일" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### 이메일 시퀀스

추심은 두 가지 이메일 시퀀스 — **보류 중** 및 **취소됨** — 각각 최대 4개의 구성 가능한 이메일을 지원합니다.

각 이메일에는 다음과 같은 구성 가능한 필드가 있습니다:

| 설정        | 설명                         |
| --------- | -------------------------- |
| **활성화됨**  | 삭제하지 않고 개별 이메일을 켜거나 끕니다    |
| **지연**    | 트리거 이벤트 후 해당 이메일 발송까지의 시간  |
| **제목**    | 변수 자리 표시자가 포함된 이메일 제목      |
| **본문**    | 변수 자리 표시자가 포함된 HTML 이메일 본문 |
| **답장 주소** | 고객의 답장을 위한 이메일 주소          |

**기본 이메일 타이밍:**

| 시퀀스  | 이메일 # | 기본 지연 |
| ---- | ----- | ----- |
| 보류 중 | 1     | 1일    |
| 보류 중 | 2     | 3일    |
| 보류 중 | 3     | 5일    |
| 보류 중 | 4     | 7일    |
| 취소됨  | 1     | 1일    |
| 취소됨  | 2     | 3일    |
| 취소됨  | 3     | 5일    |
| 취소됨  | 4     | 7일    |

### 추심 이메일 예제

추심은 구독 상태에 따라 다른 이메일을 보냅니다. 아래는 고객이 보는 각 유형의 예시입니다.

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="보류 중인 구독을 위한 추심 이메일: 상점 이름, 결제 실패 메시지, 플랜 및 금액과 함께 구독 세부 정보, 결제 방법 업데이트 버튼" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="취소된 구독을 위한 추심 이메일: 상점 이름, 취소 메시지, 플랜 및 금액과 함께 구독 세부 정보, 구독 재구매 버튼" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## 고객 복구 경험

고객이 추심 이메일의 링크를 클릭하면 고객 포털로 이동하여 구독 상태를 확인하고 결제 수단을 업데이트할 수 있습니다.

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="고객 포털: Pro Plan에 대한 보류 중인 구독, $95.00/년, 결제 방법 업데이트 버튼 및 결제 실패 경고 배너" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

고객이 결제 수단을 업데이트하면 미납 금액에 대한 청구가 자동으로 생성됩니다. 결제가 성공하면 구독이 즉시 재활성화됩니다.

취소된 구독의 경우, 고객은 이미 구독이 제품으로 추가된 체크아웃 페이지로 이동됩니다.

## 분석

대시보드의 **분석** 섹션에서 **복구** 탭을 통해 추심의 성과를 추적하세요.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="복구 분석 대시보드: 추심 항목 수, 성공률, 복구된 수익 및 이메일별 성과 분석" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| 지표         | 설명                       |
| ---------- | ------------------------ |
| **추심 항목**  | 생성된 추심 시도의 총 수           |
| **성공률**    | 추심 시도가 복구로 이어진 비율        |
| **복구된 수익** | 추심을 통해 복구된 총 수익          |
| **시도별 복구** | 어떤 이메일이 복구를 유도했는지에 대한 분석 |

## 웹훅 이벤트

| 이벤트                 | 설명                   |
| ------------------- | -------------------- |
| `dunning.started`   | 특정 구독에 대한 추심 시도가 시작됨 |
| `dunning.recovered` | 추심을 통해 구독이 복구됨       |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  추심 이벤트에 대한 전체 웹훅 페이로드 스키마를 확인하세요.
</Card>

## 특수 사례

| 시나리오                     | 행동                                  |
| ------------------------ | ----------------------------------- |
| 이메일 발송 전 고객이 결제 수단을 업데이트 | 복구가 감지됨; 추심 시도가 복구된 것으로 표시됨         |
| 동일한 사업체에서 고객이 다른 구독을 구매  | 추심 시도가 소진된 것으로 표시됨                  |
| 모든 추심 이메일 소진됨            | 추심 시도가 소진된 것으로 표시되고, 구독 상태는 수정되지 않음 |

## 모범 사례

* **기본값으로 시작**: 기본 이메일 타이밍은 고객을 과도하게 압박하지 않고 긴급성을 유지하기 위해 합리적인 간격(1, 3, 5, 7일)으로 설계되었습니다.
* **성공률 모니터링**: 시퀀스에서 가장 많은 복구를 유도하는 이메일을 추적하세요. 후속 이메일의 전환율이 거의 0에 가까운 경우, 비활성화하는 것을 고려하세요.
* **지원 팀과 협력**: 지원 팀이 추심 이메일이 발송되고 있음을 알고 있어, 고객의 문의에 대비할 수 있도록 하세요.
* **구독 상태 검토**: 포괄적인 수명주기 추적을 위해 `subscription.on_hold` 및 `subscription.cancelled` 웹훅과 함께 추심을 활용하세요.

<Info>
  추심은 기존의 구독 보류 및 고객 포털에서의 재활성화 프로세스와 함께 작동합니다. 활성화되면 추가적인 통합 없이 자동으로 실행됩니다.
</Info>

## 관련

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    `dunning.started` 및 `dunning.recovered` 이벤트에 반응하세요.
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    대상 이메일을 통해 완료되지 않았거나 실패한 일회성 체크아웃을 복구하세요.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    고객 포털을 통해 고객들이 결제 수단을 업데이트합니다.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    추심 워크플로를 트리거하는 구독 상태를 이해하세요.
  </Card>
</CardGroup>