退款

从支付详情页面发起全额或部分退款，跟踪每笔退款的状态，并了解决定退款是否可以处理的规则。

从支付详情页面向客户发起全额或部分退款。退款将退回原支付方式，退款成功后，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. 退款将退回客户使用的原始支付方式。

如果不满足任何一条规则，退款请求都会被拒绝。如需帮助，请联系 [e-mail]。

​

当余额不足以支付退款时

Dodo Payments 从您的钱包余额中支付退款，而不是从原始付款中支付。如果您的余额低于退款金额，即使付款已成功，退款也会被拒绝。

您的余额可能低于某笔付款的全额，原因有以下三点：

• 付款增加的余额少于客户支付的金额。 付款到账后会计入您的钱包，随后会扣除该笔付款的税费和 Dodo Payments 交易费用。全额退款的金额可能会高于该笔付款实际增加到您余额中的金额。
• Payout 将您的余额转入银行。 在每个 Payout 日期，符合条件的余额都会转入您的银行账户。Payout 刚完成后，您的余额可能不足以支付此前某笔付款的退款。
• 其他账目使用同一余额。 之前的退款、争议及其费用发生时，都会从您的余额中扣除。

退款完成后，余额账本会记录以下条目：

账本条目	对余额的影响
退款	扣除退还给客户的金额
税费冲回	贷记退款金额中的税费
退款费用	扣除处理退款的费用

付款费用条目不会冲回，因此退款时，Dodo Payments 不会退还原始付款产生的交易费用。

如需发起余额不足以支付的退款：

1. 在 Payouts → 余额下查看您的余额。
2. 等待新付款提高您的余额，然后发起退款。退款必须在退款期限内发起，因此不要超过期限后再操作。
3. 如果退款无法等待，请使用您注册的电子邮件地址，将付款 ID 发送至 [e-mail]。

余额规则同样适用于测试模式。要端到端测试退款（包括 refund.succeeded webhook），请完成足够多的测试付款，使测试模式下的余额能够覆盖退款金额。

​

退款状态

您可以通过以下状态跟踪退款进度：

状态	描述	可能原因
succeeded	退款已处理。	—
pending	退款已提交给支付处理商，正在等待完成。	—
review	支付处理商正在审核退款，审核完成后才会继续处理。	对退款进行风险或合规检查
failed	退款无法处理。	付款存在争议，或发生银行问题

当退款达到最终状态时，Dodo Payments 会发送 refund.succeeded 或 refund.failed webhook。请参阅退款 Webhook。

​

退款页面

交易页面上的退款标签会列出每笔退款及其金额、状态、退款 ID、关联付款、退款类型、日期和原因：

• 要打开退款对应的付款详情页面，请点击关联付款列中的 ID。
• 可从 设置 → 报告导出退款。调整报告会将退款和争议合并列出，并支持 CSV 或 XLSX 格式。

退款页面如下所示：

要从后端读取退款，请使用列出退款和获取退款详情。

​

退款收据

退款成功后，Dodo Payments 会向客户发送电子邮件。邮件会显示退款金额、状态、退款 ID、原始付款金额和退款日期，并提供退款收据的链接。退款成功邮件默认启用；您可以在客户邮件下将其关闭。要从后端获取收据，请使用获取退款收据。

退款收据模板：

退款收据包括：

• 退款 ID：退款的唯一标识符，以及已退款付款的 ID。
• 退款类型：退款是全额退款还是部分退款。
• 退款金额：退还给客户的金额，以及其中的应税金额和税额。
• 退款日期：退款处理完成的日期。
• 退款方式：退款发送至的付款方式。
• 退款原因：退款的原因。