Skip to main content
从支付详情页面向客户发起全额或部分退款。退款将退回原支付方式,退款成功后,Dodo Payments 会向客户发送收据。

发起退款

你可以从 Payment Details Page 发起两种类型的退款:
  • 全额退款:将整笔支付金额退还给客户。
  • 部分退款:退还部分支付金额。你可以为每个商品设置退款金额。
首先,点击 Initiate Refund,然后选择 Full refund 或 Partial refund。只有满足所有退款规则时,退款才会处理。
支付详情页面上的发起退款按钮
当只需要退还订单的一部分时,部分退款非常实用。
要从后端发起退款,请调用 Create Refund,并传入 payment_id。对于部分退款,请传入 items,每项都包含一个 item_id(product_id 或附加项 ID),以及要退款的最小货币单位金额 amount。

退款所需详情

  • 退款金额:要退款的金额。对于部分退款,请输入要退还给客户的每个商品的金额。控制面板会显示每个商品可退款的金额,并防止退款金额超过原始支付金额。
  • 退款原因:退款原因,该原因会与退款一起记录。控制面板要求至少输入 5 个字符,API 最多接受 3,000 个字符。
确认前,控制面板会显示退还给客户的商品价格、税费和退款总额。

退款规则

  1. 支付必须已成功。
  2. 全额或部分退款必须在退款期限内发起,默认期限为支付日期起 30 天。期限结束后,不允许发起退款。
  3. 本次退款金额与该笔支付之前的所有退款金额之和不能超过已支付金额。
  4. 每笔支付同时只能有一笔退款处于处理中。状态为 pending 或 review 的退款必须完成后,才能发起另一笔退款。
  5. 你的余额必须足以覆盖退款金额。
  6. 在 live mode 下,你的商家必须启用 live payments。
  7. 退款将退回客户使用的原始支付方式。
如果不满足任何一条规则,退款请求都会被拒绝。如需帮助,请联系 support@dodopayments.com。

退款状态

你可以通过以下状态跟踪退款进度: 当退款达到最终状态时,Dodo Payments 会发送 refund.succeeded 或 refund.failed webhook。请参阅 退款 Webhook。

退款页面

Transactions 页面上的 Refunds 选项卡会列出每笔退款及其金额、状态、退款 ID、关联付款、退款类型、日期和原因:
  • 要打开退款对应付款的 Payment Details Page,请点击 Associated Payment 列中的付款 ID。
  • 可从 Settings → Reports 导出退款。Adjustments Report 以 CSV 或 XLSX 格式同时涵盖退款和争议。
Refunds 页面如下所示:
显示退款交易列表的退款页面
要从后端读取退款,请使用 List Refunds 和 Get Refund Detail。

退款收据

退款成功后,Dodo Payments 会向客户发送电子邮件。邮件会显示退款金额、状态、Refund ID、原始付款金额和退款日期,并链接到 Refund Receipt。Refund Successful 电子邮件默认启用;您可以在 Customer Emails 下将其关闭。要从后端获取收据,请使用 Get Refund Receipt。 Refund Receipt Template:
显示退款详情的退款收据模板
退款收据包括:
  • Refund ID:退款的唯一标识符,以及已退款付款的 ID。
  • Refund type:退款是全额退款还是部分退款。
  • Refund amount:退还给客户的金额,以及应税金额和税额。
  • Refund date:处理退款的日期。
  • Refund method:发送退款所使用的付款方式。
  • Refund reason:退款原因。
最后修改于 2026年9月26日