发起退款
你可以从 Payment Details Page 发起两种类型的退款:- 全额退款:将整笔支付金额退还给客户。
- 部分退款:退还部分支付金额。你可以为每个商品设置退款金额。

payment_id。对于部分退款,请传入 items,每项都包含一个 item_id(product_id 或附加项 ID),以及要退款的最小货币单位金额 amount。
退款所需详情
- 退款金额:要退款的金额。对于部分退款,请输入要退还给客户的每个商品的金额。控制面板会显示每个商品可退款的金额,并防止退款金额超过原始支付金额。
- 退款原因:退款原因,该原因会与退款一起记录。控制面板要求至少输入 5 个字符,API 最多接受 3,000 个字符。
退款规则
- 支付必须已成功。
- 全额或部分退款必须在退款期限内发起,默认期限为支付日期起 30 天。期限结束后,不允许发起退款。
- 本次退款金额与该笔支付之前的所有退款金额之和不能超过已支付金额。
- 每笔支付同时只能有一笔退款处于处理中。状态为
pending或review的退款必须完成后,才能发起另一笔退款。 - 你的余额必须足以覆盖退款金额。
- 在 live mode 下,你的商家必须启用 live payments。
- 退款将退回客户使用的原始支付方式。
退款状态
你可以通过以下状态跟踪退款进度:
当退款达到最终状态时,Dodo Payments 会发送
refund.succeeded 或 refund.failed webhook。请参阅 退款 Webhook。
退款页面
Transactions 页面上的 Refunds 选项卡会列出每笔退款及其金额、状态、退款 ID、关联付款、退款类型、日期和原因:- 要打开退款对应付款的 Payment Details Page,请点击 Associated Payment 列中的付款 ID。
- 可从 Settings → Reports 导出退款。Adjustments Report 以 CSV 或 XLSX 格式同时涵盖退款和争议。

退款收据
退款成功后,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:退款原因。