Skip to main content
Hoàn tiền toàn bộ hoặc một phần cho khách hàng từ trang chi tiết thanh toán. Khoản hoàn tiền sẽ được gửi về phương thức thanh toán ban đầu, và Dodo Payments sẽ gửi biên lai qua email cho khách hàng khi hoàn tiền thành công.

Bắt đầu hoàn tiền

Bạn có thể bắt đầu hai loại hoàn tiền từ Trang Chi tiết Thanh toán:
  • Hoàn tiền toàn bộ: Hoàn lại toàn bộ số tiền thanh toán cho khách hàng.
  • Hoàn tiền một phần: Hoàn lại một phần khoản thanh toán. Bạn đặt số tiền cần hoàn cho từng mặt hàng.
Để bắt đầu, hãy nhấp vào Bắt đầu hoàn tiền rồi chọn Hoàn tiền toàn bộ hoặc Hoàn tiền một phần. Khoản hoàn tiền chỉ được xử lý nếu đáp ứng tất cả quy tắc hoàn tiền.
Nút bắt đầu hoàn tiền trên trang chi tiết thanh toán
Hoàn tiền một phần hữu ích khi chỉ cần hoàn tiền cho một phần đơn hàng.
Để hoàn tiền từ backend, hãy gọi Create Refund với payment_id. Để hoàn tiền một phần, hãy truyền items, mỗi mục đi kèm với item_id (ID product_id hoặc ID tiện ích bổ sung) và amount để hoàn tiền theo đơn vị tiền tệ nhỏ nhất.

Thông tin bắt buộc để hoàn tiền

  • Số tiền hoàn tiền: Số tiền cần hoàn. Đối với hoàn tiền một phần, hãy nhập số tiền cho từng mặt hàng bạn muốn hoàn lại cho khách hàng. Dashboard hiển thị số tiền có thể hoàn của từng mặt hàng và ngăn bạn hoàn nhiều hơn số tiền thanh toán ban đầu.
  • Lý do hoàn tiền: Lý do hoàn tiền, được ghi lại cùng với khoản hoàn tiền. Dashboard yêu cầu tối thiểu 5 ký tự, còn API chấp nhận tối đa 3.000 ký tự.
Trước khi xác nhận, dashboard hiển thị số tiền hoàn theo giá, số tiền hoàn thuế và tổng số tiền hoàn cho khách hàng.

Quy tắc hoàn tiền

  1. Khoản thanh toán phải thành công.
  2. Hoàn tiền (toàn bộ hoặc một phần) phải được bắt đầu trong thời hạn hoàn tiền, mặc định là 30 ngày kể từ ngày thanh toán. Sau khi thời hạn kết thúc, không được phép hoàn tiền.
  3. Khoản hoàn tiền cùng với mọi khoản hoàn tiền trước đó cho khoản thanh toán không được vượt quá số tiền đã thanh toán.
  4. Chỉ một khoản hoàn tiền cho mỗi khoản thanh toán có thể đang được xử lý. Khoản hoàn tiền có trạng thái pending hoặc review phải hoàn tất trước khi bạn bắt đầu khoản khác.
  5. Số dư của bạn phải đủ để chi trả khoản hoàn tiền.
  6. Trong live mode, live payments phải được bật cho doanh nghiệp của bạn.
  7. Khoản hoàn tiền được phát hành về phương thức thanh toán ban đầu mà khách hàng đã sử dụng.
Nếu bất kỳ quy tắc nào không được đáp ứng, yêu cầu hoàn tiền sẽ bị từ chối. Để được hỗ trợ, hãy liên hệ support@dodopayments.com.

Khi số dư của bạn không đủ để hoàn tiền

Dodo Payments hoàn tiền từ số dư ví của bạn, không phải từ khoản thanh toán ban đầu. Nếu số dư của bạn thấp hơn số tiền hoàn, yêu cầu hoàn tiền sẽ bị từ chối, ngay cả khi khoản thanh toán đã thành công. Số dư của bạn có thể thấp hơn toàn bộ số tiền thanh toán vì ba lý do:
  • Một khoản thanh toán cộng vào số dư ít hơn số tiền khách hàng đã trả. Ví của bạn được ghi có khoản thanh toán, sau đó thuế trên khoản thanh toán và phí giao dịch Dodo Payments sẽ được ghi nợ. Một khoản hoàn tiền đầy đủ sẽ trả lại nhiều hơn số tiền khoản thanh toán đã cộng vào số dư.
  • Một khoản chi trả chuyển số dư của bạn vào ngân hàng. Vào mỗi ngày chi trả, số dư đủ điều kiện của bạn được chuyển vào tài khoản ngân hàng. Ngay sau một khoản chi trả, số dư của bạn có thể không đủ để hoàn tiền cho một khoản thanh toán được thực hiện trước đó.
  • Các mục khác sử dụng cùng số dư. Các khoản hoàn tiền, tranh chấp và phí liên quan trước đó sẽ được khấu trừ khỏi số dư của bạn khi phát sinh.
Khi một khoản hoàn tiền được thực hiện, sổ cái Balances sẽ ghi lại các mục sau: Mục Payment Fees không có bút toán đảo ngược, vì vậy Dodo Payments không hoàn lại phí giao dịch của khoản thanh toán ban đầu khi bạn hoàn tiền. Để thực hiện khoản hoàn tiền mà số dư của bạn hiện không đủ chi trả:
  1. Kiểm tra số dư của bạn trong Payouts → Balances.
  2. Chờ các khoản thanh toán mới làm tăng số dư, sau đó bắt đầu hoàn tiền. Bạn phải bắt đầu hoàn tiền trong thời hạn hoàn tiền, vì vậy đừng chờ quá thời hạn này.
  3. Nếu không thể chờ để hoàn tiền, hãy gửi email từ địa chỉ email đã đăng ký của bạn đến support@dodopayments.com, kèm theo payment ID.
Quy tắc về số dư cũng áp dụng trong test mode. Để kiểm thử quy trình hoàn tiền từ đầu đến cuối, bao gồm webhook refund.succeeded, hãy hoàn tất đủ các khoản thanh toán thử nghiệm để số dư trong test mode của bạn đủ chi trả số tiền hoàn.

Trạng thái hoàn tiền

Theo dõi tiến trình hoàn tiền của bạn bằng các trạng thái sau: Dodo Payments gửi webhook refund.succeeded hoặc refund.failed khi khoản hoàn tiền đạt trạng thái cuối cùng. Xem Refund Webhooks.

Trang Refunds

Tab Refunds trên trang Transactions liệt kê mọi khoản hoàn tiền, cùng với số tiền, trạng thái, refund ID, khoản thanh toán liên quan, loại hoàn tiền, ngày và lý do:
  • Để mở Payment Details Page của khoản thanh toán được hoàn tiền, hãy nhấp vào ID của khoản thanh toán trong cột Associated Payment.
  • Các khoản hoàn tiền được xuất từ Settings → Reports. Adjustments Report bao gồm cả khoản hoàn tiền và tranh chấp, ở định dạng CSV hoặc XLSX.
Trang Refunds có dạng như sau:
Refunds page showing a list of refund transactions
Để đọc các khoản hoàn tiền từ backend, hãy sử dụng List Refunds và Get Refund Detail.

Biên lai hoàn tiền

Khi một khoản hoàn tiền thành công, Dodo Payments sẽ gửi email cho khách hàng. Email hiển thị số tiền hoàn, trạng thái, Refund ID, số tiền thanh toán ban đầu và ngày hoàn tiền, đồng thời liên kết đến Refund Receipt. Email Refund Successful được bật theo mặc định; bạn có thể tắt email này trong Customer Emails. Để lấy biên lai từ backend, hãy sử dụng Get Refund Receipt. Mẫu Refund Receipt:
Refund receipt template showing the refund details
Biên lai hoàn tiền bao gồm:
  • Refund ID: Mã nhận dạng duy nhất của khoản hoàn tiền, cùng với ID của khoản thanh toán được hoàn tiền.
  • Refund type: Cho biết khoản hoàn tiền là hoàn tiền đầy đủ hay một phần.
  • Refund amount: Số tiền hoàn lại cho khách hàng, cùng với số tiền chịu thuế và số tiền thuế.
  • Refund date: Ngày khoản hoàn tiền được xử lý.
  • Refund method: Phương thức thanh toán mà khoản hoàn tiền được gửi đến.
  • Refund reason: Lý do hoàn tiền.
Lần sửa đổi cuối 8 tháng 10, 2026