Payment Retries tự động tính phí lại các khoản thanh toán gia hạn subscription thất bại theo lịch giãn dần. Khi một lần thử lại thành công, subscription trở về
active mà không cần khách hàng thực hiện thao tác nào và không cần công việc tích hợp.Payment Retries Là Gì?
Khi khoản thanh toán gia hạn subscription thất bại, subscription chuyển sangon_hold hoặc sang past_due nếu bạn đặt thời gian gia hạn. Khi bật Payment Retries, Dodo Payments sẽ tính phí lại phương thức thanh toán đã lưu của khách hàng theo lịch cho đến khi một lần tính phí thành công hoặc thời gian khôi phục kết thúc.
Retries giúp thu hồi doanh thu bị mất do các lỗi tạm thời, chẳng hạn như thẻ đang bị tạm giữ, không đủ số dư nhưng khách hàng sẽ nạp thêm sau đó, hoặc lỗi mạng tạm thời. Khách hàng không nhận được email và không cần thay đổi bất cứ điều gì.
Payment Retries chỉ áp dụng cho các khoản thanh toán gia hạn subscription. Khoản thanh toán đầu tiên của subscription (thiết lập mandate), các khoản thanh toán một lần, khoản phí thay đổi plan và khoản phí theo yêu cầu không được thử lại.
Cách Hoạt động của Payment Retries
1
Renewal fails
Khoản thanh toán gia hạn subscription thất bại và subscription chuyển sang
on_hold hoặc sang past_due trong thời gian gia hạn.2
Retryability check
Dodo Payments kiểm tra mã lỗi của lần thất bại. Soft declines, chẳng hạn như không đủ số dư, từ chối chung chung hoặc lỗi xử lý hay lỗi mạng, có thể được thử lại. Hard declines kết thúc chuỗi thử lại vì một lần thử khác sẽ không thay đổi kết quả. Lỗi không có mã lỗi được xem là hard decline.
3
Scheduled retry
Nếu khoản từ chối có thể được thử lại và lần thử tiếp theo nằm trong thời gian khôi phục, Dodo Payments sẽ lên lịch cho lần thử đó. Mỗi lần thử lại là một khoản tính phí off-session vào phương thức thanh toán đã lưu của khách hàng và mỗi khoảng trễ được tính từ lần thất bại trước đó.
4
Recovery
Ở lần thử lại thành công đầu tiên, subscription trở về
active và ngày thanh toán tiếp theo được chuyển sang một kỳ thanh toán sau lần thử lại thành công. Nếu thời gian khôi phục kết thúc trước khi bất kỳ lần thử lại nào thành công, retries sẽ dừng và subscription giữ nguyên trạng thái, chẳng hạn như on_hold.Cấu hình Payment Retries
Bật và cấu hình Payment Retries trong Cài đặt → Khôi phục trên dashboard.
Payment Retries settings under Settings → Recovery
Thời gian khôi phục bắt đầu khi invoice cho lần gia hạn thất bại được tạo. Dodo Payments chỉ lên lịch một lần thử nếu tổng tất cả khoảng trễ cho đến lần thử đó nằm trong thời gian khôi phục và chỉ khi thời gian khôi phục vẫn còn hiệu lực.
Lịch thử lại
Retries có khoảng trễ tăng dần. Dodo Payments thực hiện tối đa 8 lần thử, miễn là mỗi lần đều nằm trong thời gian khôi phục của bạn:Chuyển đổi trạng thái subscription
Retries chuyển subscription giữa các trạng thái sau:Khi subscription bị hủy, chuỗi thử lại kết thúc và không thực hiện thêm lần thử nào. Mọi trạng thái khác (
on_hold, past_due, expired, pending, failed) vẫn tiếp tục được thử lại vì invoice gia hạn đang mở là một khoản nợ cho kỳ mà khách hàng đã sử dụng. Retries cũng dừng khi invoice được thanh toán bằng cách khác, chẳng hạn sau khi khách hàng cập nhật phương thức thanh toán hoặc khi bạn thêm khách hàng vào blocklist.Subscription Webhook Payloads
Xem đầy đủ schema payload webhook cho các sự kiện vòng đời subscription.
Lỗi có thể và không thể thử lại
Mã lỗi của lần thất bại gần nhất quyết định chuỗi có tiếp tục hay không:Thử lại một hard decline sẽ không thay đổi kết quả, vì vậy chuỗi kết thúc ngay khi hard decline xảy ra. Kết hợp Payment Retries với Subscription Dunning để yêu cầu khách hàng cung cấp phương thức thanh toán mới trong những trường hợp đó. Để biết loại của từng mã, hãy xem Transaction Failures.
Thử lại theo yêu cầu
Bạn không cần chờ đến lần thử đã lên lịch tiếp theo. Khi subscription ở trạng tháion_hold, bạn có thể gửi một lần thử lại từ trang chi tiết khoản thanh toán thất bại trong dashboard hoặc bằng POST /payments/{payment_id}/retry. Các lần thử lại thủ công hoạt động độc lập với lịch: chúng không tiêu tốn hoặc di chuyển một lần thử tự động và vẫn hoạt động ngay cả khi Payment Retries bị tắt. Xem Manual Payment Retry.
Payment Retries và Dunning
Payment Retries và Subscription Dunning xử lý các loại lỗi khác nhau:
Bật cả hai để có phạm vi bao phủ rộng nhất: retries tự động xử lý các lỗi tạm thời, còn dunning khôi phục những khách hàng có phương thức thanh toán cần được thay thế.
Liên quan
Manual Payment Retry
Gửi một lần thử lại ngay thay vì chờ lần thử đã lên lịch tiếp theo.
Subscription Dunning
Các chuỗi email yêu cầu khách hàng cập nhật phương thức thanh toán.
Abandoned Cart Recovery
Khôi phục các phiên checkout bị bỏ dở hoặc thất bại bằng email khôi phục.
Subscriptions
Các trạng thái subscription mà những luồng khôi phục chuyển đổi qua lại.
Subscription Webhooks
Phản hồi các sự kiện
subscription.on_hold và subscription.active.