Chuyển đến nội dung chính
Payment Retries tự động thử lại các khoản thanh toán gia hạn đăng ký thất bại theo lịch trình tăng dần. Khi một lần thử lại thành công, đăng ký sẽ được kích hoạt lại tự động — không cần hành động của khách hàng hoặc công việc tích hợp.

Payment Retries Là Gì?

Khi một khoản thanh toán gia hạn đăng ký thất bại, đăng ký sẽ được đặt tạm ngưng. Với Payment Retries được kích hoạt, Dodo Payments sẽ tự động tính lại phương thức thanh toán hiện có của khách hàng theo lịch trình thông minh cho đến khi thanh toán thành công hoặc cửa sổ khôi phục đóng lại. Điều này giúp thu hồi doanh thu mất mát do các lỗi tạm thời — thẻ hết hạn, không đủ tiền được nạp đầy, lỗi mạng tạm thời — mà không cần gửi email khách hàng hoặc yêu cầu họ cập nhật bất cứ điều gì.
Payment Retries chỉ áp dụng cho các khoản thanh toán gia hạn đăng ký. Các khoản thanh toán đầu tiên (thiết lập ủy quyền), khoản thanh toán một lần, phí thay đổi gói, và phí theo yêu cầu không được thử lại bởi tính năng này.

Cách Hoạt động của Payment Retries

1

Renewal fails

Một khoản thanh toán gia hạn đăng ký thất bại và đăng ký chuyển sang trạng thái on_hold.
2

Retryability check

Mã lỗi của lỗi được kiểm tra. Soft declines (không đủ tiền, từ chối chung, lỗi xử lý hoặc mạng, v.v.) có thể thử lại. Hard declines kết thúc chuỗi thử lại ngay lập tức, vì thử lại sẽ không thay đổi kết quả.
3

Scheduled retry

Nếu từ chối có thể thử lại và cửa sổ khôi phục cho phép, thử lại tiếp theo được lên lịch. Các lần thử lại tiến hành không trong phiên đối với phương thức thanh toán hiện có của khách hàng theo lịch trình tăng dần.
4

Recovery

Khi thử lại thành công đầu tiên, đăng ký trở lại trạng thái active và ngày thanh toán tiếp theo được nâng lên như bình thường. Nếu cửa sổ đóng lại trước khi thử lại nào thành công, việc thử lại dừng và đăng ký vẫn nằm ở trạng thái tạm ngưng.

Cấu hình Payment Retries

Kích hoạt và cấu hình Payment Retries từ Cài đặt → Khôi phục trong bảng điều khiển của bạn.
Trang Cài đặt Khôi phục với công tắc Enable Payment Retries bật và trường Recovery window (ngày) được đặt thành 13
Cài đặtMô tảMặc định
Enable Payment RetriesTự động thử lại các khoản thanh toán gia hạn đăng ký thất bại để thu hồi doanh thu.Tắt (đăng ký)
Cửa sổ khôi phục (ngày)Thời gian thử lại một khoản thanh toán thất bại trước khi từ bỏ. Phải nằm trong khoảng từ 1 đến 30.13
Cửa sổ khôi phục được gắn với thời gian hóa đơn gia hạn thất bại được tạo. Các lần thử lại chỉ được lên lịch trong khi tổng thời gian trì hoãn vẫn nằm trong cửa sổ.

Lịch trình Thử lại

Thử lại tiến hành lùi dần. Tối đa 8 lần thử được thực hiện, miễn là mỗi lần đều nằm trong cửa sổ khôi phục của bạn:
Lần thửTrì hoãn sau lần thử trướcThời gian ước tính kể từ khi thất bại
112 giờ12 giờ
224 giờ36 giờ
348 giờ~3.5 ngày
472 giờ~6.5 ngày
596 giờ~10.5 ngày
6120 giờ~15.5 ngày
77 ngày~22.5 ngày
87 ngày~29.5 ngày
Một cửa sổ khôi phục 13 ngày (mặc định) bao gồm các lần thử 1 đến 5 (lần thử 5 bắn ra ~10.5 ngày sau khi thất bại). Tăng cửa sổ về phía tối đa 30 ngày nếu bạn muốn các lần thử sau, với khoảng cách rộng hơn (6 đến 8) chạy.

Chuyển đổi Trạng thái Đăng ký

Sự kiệnTrạng thái đăng ký
Gia hạn thanh toán thất bạiactiveon_hold
Lần thử lại thất bạiở lại on_hold (lần thử lại tiếp theo được lên lịch nếu cửa sổ cho phép)
Lần thử lại thành côngon_holdactive, ngày thanh toán tiếp theo được nâng cao
Cửa sổ khôi phục hết hạnở lại on_hold
Các chuyển đổi này phát ra các sự kiện webhook đăng ký tiêu chuẩn, vì vậy bạn có thể điều khiển logic quyền từ chúng mà không cần xử lý thử lại đặc biệt:
Sự kiệnPhát khi
subscription.on_holdMột lần gia hạn thất bại và đăng ký được đặt trong trạng thái tạm ngưng
subscription.activeMột lần thử lại thành công và đăng ký được kích hoạt lại

Subscription Webhook Payloads

Xem toàn bộ mô tả payload webhook cho các sự kiện vòng đời đăng ký.

Thất bại Có thể Thử lại và Không Thể Thử lại

Loại thất bạiVí dụCó Thử lại?
Soft declineKhông đủ tiền, từ chối chung, vượt quá tốc độ thẻ, lỗi xử lý, lỗi mạng/hết thời gian, thử lại sau
Hard declineThẻ mất cắp/mất, thẻ không hợp lệ, không chấp nhận, tài khoản đóng, và các từ chối cuối cùng khácKhông — chuỗi kết thúc ngay lập tức
Thử lại một từ chối khó sẽ không thay đổi kết quả, vì vậy chuỗi thử lại kết thúc ngay khi gặp phải một từ chối khó. Kết hợp Payment Retries với Dunning Đăng ký để nhắc nhở khách hàng cập nhật phương thức thanh toán của họ trong những trường hợp đó.

Payment Retries so với Dunning

Payment Retries và Dunning Đăng ký là những công cụ khôi phục bổ sung:
Payment RetriesDunning Đăng ký
Cơ chếLặng lẽ tái nạp phương thức thanh toán hiện cóGửi email nhắc nhở khách hàng cập nhật phương thức thanh toán
Hành động khách hàngKhông yêu cầuKhách hàng cập nhật phương thức thanh toán trong cổng thông tin
Tốt nhất choCác từ chối tạm thời/mềm mà tự giải quyếtThẻ hết hạn hoặc không hợp lệ cần thay thế
Kích hoạt cả hai giúp bạn mở rộng phạm vi khôi phục: các lần thử lại tự động bắt các lỗi tạm thời, trong khi dunning đem lại khách hàng mà phương thức thanh toán thực sự cần cập nhật.

Liên quan

Subscription Dunning

Chuỗi email nhắc nhở khách hàng cập nhật phương thức thanh toán của họ.

Abandoned Cart Recovery

Khôi phục các lần thanh toán một lần không hoàn tất hoặc thất bại với các email nhắm mục tiêu.

Subscriptions

Hiểu các trạng thái đăng ký liên quan trong các dòng khôi phục.

Subscription Webhooks

Phản ứng với các sự kiện subscription.on_holdsubscription.active.
Last modified on June 9, 2026