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

# Thu hồi Đăng ký

> Tự động gửi chuỗi email để khôi phục các đăng ký đã mất hoặc bị hủy bằng cách nhắc nhở khách hàng cập nhật phương thức thanh toán của họ.

<Info>
  Thu hồi Đăng ký tự động gửi chuỗi email đến khách hàng có đăng ký bị gián đoạn do thất bại thanh toán hoặc khách hàng hủy bỏ, nhắc nhở họ cập nhật phương thức thanh toán và kích hoạt lại.
</Info>

## Thu hồi Đăng ký là gì?

Dunning tự động phát hiện khi một đăng ký ở trạng thái có thể khôi phục và gửi một chuỗi email để nhắc nhở khách hàng hành động:

* **Đăng ký Đang Giữ**: Thanh toán gia hạn thất bại (không đủ tiền, thẻ hết hạn, v.v.)
* **Đăng ký Bị Hủy**: Khách hàng hủy bỏ từ cổng khách hàng

## Cách Dunning Hoạt Động

<Steps>
  <Step title="Trigger">
    Dunning được kích hoạt khi một đăng ký vào một trong hai trạng thái:

    * **Đang Giữ**: Thanh toán gia hạn thất bại (không đủ tiền, thẻ hết hạn, v.v.)
    * **Bị Hủy**: Khách hàng đã hủy đăng ký của họ từ cổng khách hàng
  </Step>

  <Step title="Email Sequence">
    Dựa trên trạng thái kích hoạt, hệ thống gửi tối đa 4 email dunning vào
    các khoảng thời gian được cấu hình. Mỗi email bao gồm một liên kết đến cổng khách hàng nơi
    khách hàng có thể cập nhật phương thức thanh toán của họ hoặc mua lại đăng ký.
  </Step>

  <Step title="Recovery">
    Khi khách hàng cập nhật phương thức thanh toán của họ qua cổng khách hàng, một khoản phí sẽ được tự động tạo ra cho các khoản nợ còn lại. Nếu thanh toán thành công, đăng ký được kích hoạt lại và nỗ lực dunning được đánh dấu là đã khôi phục.
  </Step>
</Steps>

## Vòng Đời Trạng Thái

| Trạng thái   | Mô tả                                                                               |
| ------------ | ----------------------------------------------------------------------------------- |
| `recovering` | Nỗ lực dunning đang hoạt động; các email đang được gửi                              |
| `recovered`  | Khách hàng đã cập nhật phương thức thanh toán và thanh toán thành công              |
| `exhausted`  | Tất cả email đã gửi mà không có khôi phục, hoặc trạng thái đăng ký thay đổi bất ngờ |

<Info>
  Khi một nỗ lực dunning được đánh dấu là `exhausted`, trạng thái đăng ký không được thay đổi. Đăng ký vẫn giữ nguyên trạng thái hiện tại của nó (đang giữ hoặc bị hủy).
</Info>

## Cấu Hình Dunning

Bật và cấu hình Dunning từ **Cài đặt** trong bảng điều khiển của bạn.

<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="Trang cài đặt Dunning với công tắc bật, bốn email giữ tại các khoảng 1, 3, 5, và 7 ngày, và bốn email hủy bỏ vào cùng khoảng thời gian" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### Chuỗi Email

Dunning hỗ trợ hai chuỗi email — **Đang Giữ** và **Bị Hủy** — mỗi chuỗi có tối đa 4 email có thể cấu hình.

Mỗi email có các trường có thể cấu hình sau:

| Cài đặt          | Mô tả                                          |
| ---------------- | ---------------------------------------------- |
| **Bật**          | Chuyển đổi email cá nhân mà không xóa chúng    |
| **Chậm trễ**     | Bao lâu sau sự kiện kích hoạt để gửi email này |
| **Tiêu đề**      | Dòng tiêu đề email với các biến giữ chỗ        |
| **Nội dung**     | Thân email HTML với các biến giữ chỗ           |
| **Phản hồi đến** | Địa chỉ email cho phản hồi của khách hàng      |

**Thời gian mặc định của email:**

| Chuỗi    | # Email | Chậm trễ Mặc định |
| -------- | ------- | ----------------- |
| Đang Giữ | 1       | 1 ngày            |
| Đang Giữ | 2       | 3 ngày            |
| Đang Giữ | 3       | 5 ngày            |
| Đang Giữ | 4       | 7 ngày            |
| Bị Hủy   | 1       | 1 ngày            |
| Bị Hủy   | 2       | 3 ngày            |
| Bị Hủy   | 3       | 5 ngày            |
| Bị Hủy   | 4       | 7 ngày            |

### Ví dụ Email Dunning

Dunning gửi các email khác nhau tùy thuộc vào trạng thái đăng ký. Dưới đây là các ví dụ về mỗi loại mà khách hàng thấy.

<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="Email dunning cho đăng ký đang giữ hiển thị tên cửa hàng, thông điệp về thanh toán thất bại, chi tiết đăng ký với kế hoạch và số tiền, và nút Cập nhật Phương thức Thanh toán" 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="Email dunning cho đăng ký bị hủy hiển thị tên cửa hàng, thông điệp về hủy bỏ, chi tiết đăng ký với kế hoạch và số tiền, và nút Mua lại Đăng ký" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## Trải Nghiệm Khách Hàng Khôi Phục

Khi khách hàng nhấp vào liên kết trong email dunning, họ sẽ được chuyển đến cổng khách hàng, nơi họ có thể xem trạng thái đăng ký của mình và cập nhật phương thức thanh toán của họ.

<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="Cổng khách hàng hiển thị đăng ký đang giữ cho Pro Plan với $95.00/năm cùng nút Cập nhật phương thức thanh toán và cảnh báo về thanh toán thất bại" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

Sau khi khách hàng cập nhật phương thức thanh toán của họ, một khoản phí sẽ được tự động tạo ra cho các khoản nợ chưa thanh toán. Nếu thanh toán thành công, đăng ký sẽ được kích hoạt lại ngay lập tức.

Đối với một đăng ký bị hủy, khách hàng sẽ được chuyển đến trang thanh toán đã có sản phẩm là đăng ký.

## Phân Tích

Theo dõi hiệu suất của Dunning từ tab **Khôi phục** trong phần **Phân tích** của bảng điều khiển của bạn.

<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="Bảng điều khiển phân tích khôi phục hiển thị số lượng mục dunning, tỉ lệ thành công, doanh thu đã khôi phục, và phân tích hiệu suất của từng email" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| Chỉ số                     | Mô tả                                                |
| -------------------------- | ---------------------------------------------------- |
| **Các mục Dunning**        | Tổng số nỗ lực dunning đã tạo                        |
| **Tỉ lệ Thành công**       | Phần trăm các nỗ lực dunning dẫn đến khôi phục       |
| **Doanh Thu Đã Khôi Phục** | Tổng doanh thu được khôi phục qua dunning            |
| **Khôi phục theo Nỗ lực**  | Phân tích email nào trong chuỗi đã dẫn đến khôi phục |

## Sự Kiện Webhook

| Sự kiện             | Mô tả                                           |
| ------------------- | ----------------------------------------------- |
| `dunning.started`   | Một nỗ lực dunning đã bắt đầu cho một đăng ký   |
| `dunning.recovered` | Một đăng ký đã được khôi phục thông qua dunning |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  Xem đầy đủ các dạng tải trọng webhook cho các sự kiện dunning.
</Card>

## Trường Hợp Đặc Biệt

| Tình huống                                                        | Hành vi                                                                   |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Khách hàng cập nhật phương thức thanh toán trước bất kỳ email nào | Phát hiện khôi phục; nỗ lực dunning được đánh dấu là đã khôi phục         |
| Khách hàng mua một đăng ký khác từ cùng một doanh nghiệp          | Nỗ lực dunning được đánh dấu là đã hết                                    |
| Tất cả email dunning đã hết                                       | Nỗ lực dunning được đánh dấu là đã hết; trạng thái đăng ký không thay đổi |

## Thực Hành Tốt

* **Bắt đầu với mặc định**: Thời gian email mặc định được thiết kế với khoảng cách hợp lý (1, 3, 5 và 7 ngày) để tránh làm phiền khách hàng đồng thời duy trì cấp thiết.
* **Giám sát tỉ lệ thành công**: Theo dõi email nào trong chuỗi dẫn đến khôi phục nhiều nhất. Nếu các email sau có chuyển đổi gần bằng không, hãy cân nhắc việc vô hiệu hóa chúng.
* **Phối hợp với hỗ trợ**: Đảm bảo đội ngũ hỗ trợ của bạn biết rằng các email dunning đang được gửi, để họ có thể hỗ trợ khách hàng nào liên hệ.
* **Xem lại trạng thái đăng ký**: Kết hợp dunning với `subscription.on_hold` và `subscription.cancelled` webhooks để theo dõi vòng đời tổng thể.

<Info>
  Dunning hoạt động cùng với các quy trình đăng ký hiện có và tái kích hoạt trong cổng khách hàng. Khi được bật, nó hoạt động tự động mà không cần tích hợp thêm.
</Info>

## Liên Quan

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    Phản hồi cho sự kiện `dunning.started` và `dunning.recovered`.
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    Khôi phục các thanh toán một lần không hoàn thành hoặc thất bại với các email tùy chỉnh.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    Khách hàng cập nhật phương thức thanh toán thông qua cổng khách hàng.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Hiểu các trạng thái đăng ký tạo ra quy trình dunning.
  </Card>
</CardGroup>
