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
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.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ả.
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.
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.
| Cài đặt | Mô tả | Mặc định |
|---|---|---|
| Enable Payment Retries | Tự độ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 |
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ước | Thời gian ước tính kể từ khi thất bại |
|---|---|---|
| 1 | 12 giờ | 12 giờ |
| 2 | 24 giờ | 36 giờ |
| 3 | 48 giờ | ~3.5 ngày |
| 4 | 72 giờ | ~6.5 ngày |
| 5 | 96 giờ | ~10.5 ngày |
| 6 | 120 giờ | ~15.5 ngày |
| 7 | 7 ngày | ~22.5 ngày |
| 8 | 7 ngày | ~29.5 ngày |
Chuyển đổi Trạng thái Đăng ký
| Sự kiện | Trạng thái đăng ký |
|---|---|
| Gia hạn thanh toán thất bại | active → on_hold |
| Thử lại thất bại | giữ nguyên on_hold (lịch thử lại tiếp theo nếu cửa sổ cho phép) |
| Thử lại thành công | on_hold → active, ngày thanh toán tiếp theo được cập nhật |
| Cửa sổ khôi phục hết hạn | giữ nguyên on_hold |
| Đăng ký bị hủy | các lần thử lại được lên lịch dừng ngay lập tức (kết thúc — không có thêm thử lại nào) |
Nếu một đăng ký bị hủy trong khi các lần thử lại vẫn đang được lên lịch, chuỗi thử lại sẽ kết thúc ngay lập tức và không có thêm nỗ lực nào được thực hiện. Các trạng thái không hoạt động khác (
on_hold, expired, pending, failed) tiếp tục thử lại, vì hóa đơn gia hạn mở của chúng đại diện cho khoản nợ cho các khoảng thời gian mà khách hàng đã tiêu thụ.| Sự kiện | Phát khi |
|---|---|
subscription.on_hold | Gia hạn thất bại và đăng ký bị tạm dừng |
subscription.active | Thử lại thành công và đăng ký được kích hoạt lại |
Subscription Webhook Payloads
Xem các schema tải dữ liệu webhook đầy đủ 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ại | Ví dụ | Thử lại? |
|---|---|---|
| Từ chối mềm | Khô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 | Có |
| Từ chối cứng | Thẻ bị mất/cướp, thẻ không hợp lệ, không chấp nhận, tài khoản đã đóng và các từ chối kết thúc khác | Không — chuỗi kết thúc ngay lập tức |
Thử lại từ chối cứng sẽ không thay đổi kết quả, vì vậy chuỗi thử lại kết thúc ngay khi có từ chối cứng. Kết hợp Thử Lại Thanh Toán với Subscription Dunning để thúc đẩy khách hàng cập nhật phương thức thanh toán của họ trong các trường hợp đó.
Thử Lại Thanh Toán và Dunning
Thử Lại Thanh Toán và Subscription Dunning là công cụ khôi phục bổ trợ:| Thử Lại Thanh Toán | Subscription Dunning | |
|---|---|---|
| Cơ chế | Âm thầm sạc lại phương thức thanh toán hiện có | Gửi email cho khách hàng để cập nhật phương thức thanh toán |
| Hành động của khách hàng | Không cần thiết | Khách hàng cập nhật phương thức thanh toán trong cổng thông tin |
| Thích hợp cho | Từ chối mềm/tạm thời tự khắc phục | Thẻ hết hạn hoặc không hợp lệ cần thay thế |
Liên quan
Subscription Dunning
Chuỗi email thúc đẩy 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 thanh toán một lần không hoàn thành hoặc thất bại với email nhắm mục tiêu.
Subscriptions
Hiểu các trạng thái đăng ký có liên quan trong các luồng khôi phục.
Subscription Webhooks
Phản hồi các sự kiện
subscription.on_hold và subscription.active.