我的结算明细里有一行 CHARGEBACK，Event Type 有哪些？资金是进还是出？
对于拒付变动，Transaction Type 始终为 CHARGEBACK。Event Type 列告诉您该行是扣款还是退回，以及它承载的是金额、手续费，还是两者都有：
看模式而不是看金额，才是可靠的读法：
*_PRE_DEDUCT 总是扣钱，*_AMOUNT_REFUND 总是退钱，手续费只会出现在 PRE_DEDUCT 行上。因此一个开案、升级、最终胜诉的案件，会在不同结算日期产生三到四行独立的 CHARGEBACK 记录——而不是一行净额。
哪些案件状态会产生哪种事件：
请注意
CASE_LOST 的后果：没有单独的”败诉”事件。您在开案时已经被扣款，因此败诉不会产生新的行——没有 AMOUNT_REFUND 行就是败诉。时间和结算日规则见
拒付与争议 FAQ。
较早的记录可能带有空的 Event Type。这些记录早于此细分方式，且始终是扣款。
拒付详情页上的 Compulsory Channel Review 是什么？
compulsoryChannelReview 是案件上的一个 true/false 标志，返回给 Portal，记录支付侧是否强制要求对该案件进行其自身的审核。拒付创建时该值为 true；通过应用内投诉流程发起的客户争议创建时该值为 false。
请把它当作对结果预期的提示：为 true 时，案件由审核方裁决，您的提交是该审核的输入，而不是案件的解决方式。为 false 时，直接与客户解决案件是一个切实可行的选项，而关闭争议就是记录该解决结果的方式（前提是该标志为 false 才会出现 Close 操作）。
关闭操作是否可用由案件状态和这个标志共同决定：案件须是客户争议，处于 EVIDENCE_REQUIRED、ACTION_REQUIRED 或 UNDER_REVIEW 状态，且该标志为 false，同时你的用户拥有争议更新权限；ESCALATED 状态的案件不能关闭，拒付不提供关闭操作。因此如果没有 Close 按钮，请依次检查案件类型、状态、该标志和你的权限。
客户争议时间线里每个事件是什么意思？
时间线记录 11 种事件值。不在此列表中的都不是时间线事件。拒付时间线里每个事件是什么意思？
14 种事件值，与客户争议的集合不同：AUTO_SUBMITS_EVIDENCE 和 CREATE_SECOND_CYCLE_DISPUTE 是两个可以在您没有任何操作的情况下出现的事件。如果您设置了统一的处理策略，就是在这里看到它已触发。
哪些时间线事件会增加未读计数？
恰好三个，且三个都是收到的消息而不是状态变化：USER_RESPONSEPLATFORM_RESPONSEUSER_CREATE_COMPLAINT
MERCHANT_RESPONSE 不会增加计数，任何状态变化、任何证据提交或任何截止时间事件也都不会。因此未读计数永远表示有人对您说了什么，而不是案件发生了什么——一个案件可以一路走到最终状态而计数器从未变动。不要把计数器当作活动指标；请看时间线。
我提交过的证据文件还能下载吗？怎么下载？
能。用POST /api/v1/chargeback/file/download 获取之前通过上传接口提交过的证据文件。请求体（JSON）字段：
merchantId：必填，Waffo 分配的商户号，必须与该 API Key 绑定的商户一致。fileId：必填，上传接口返回的文件 ID，形如1766043193910/receipt.pdf。
data.downloadUrl 是下载地址，用普通 GET 请求即可下载；data.expiresAt 是地址的过期时间（UTC，ISO 8601），有效期 5 分钟。过期后重新调用本接口获取新地址。详见官网证据文件下载接口。
拒付对象里还有哪些字段？
除状态、金额、原因码和截止时间外，/api/v1/chargeback/inquiry 和回调通知里的拒付对象还有这几个常被问到的字段：
chargebackDateTime：渠道创建这笔拒付的时间，ISO 8601，精确到毫秒，UTC，例如2026-04-01T03:00:00.000Z。message.messageId：消息 ID，最长 32 位。对象总会返回message，可能为空。evidence.othersText：补充证据文字，最长 2048 个字符，通过/api/v1/chargeback/update提交。第一周期提交时至少还要附一个证据文件，只写文字不能提交。
A0041（Chargeback does not exist），请核对 chargebackId 和 merchantId 是否对应。
怎么导出我的拒付明细？它会走报表 Tab 吗？
拒付列表有自己的导出功能，与大多数 Portal 导出不同，它是直接同步下载：点击时文件直接流式传输到您的浏览器，任何报表 Tab 中都不会出现任务行。如果您在 导出与报表下载中找它，是找不到的——那一页覆盖的是排队导出，而这个导出不排队。 文件名为：YYYYMMDD，来自您所应用的创建时间筛选。导出遵循您当前的列表筛选条件，因此先筛选，再导出。
拒付 CSV 导出里有哪些列？
26 列，顺序如下：
每个表头都是唯一的，因此按表头文本解析是安全的。请注意，对于相同的值，导出文件中写的是 Chargeback，而 Portal 详情页写的是 Dispute——第 12 列和第 25 列分别是争议金额和手续费，不是两个金额。
第 21 列显示案件尚未结算，钱到底扣了没扣？
这正是Settlement Status 的用途，当案件状态与您的银行余额不一致时，就该看这一列。
Chargeback Status 和 Settlement Status 回答的是不同的问题，变化的时间也不同：
拒付在开案时就记到您的账上，但只有在原支付订单已结算之后才会出现在结算对账单中，因为它复用该订单的结算汇率。因此一个案件可能停在
ACTION_REQUIRED、金额已记账、而 Settlement Status 仍显示未结算——扣款即将到来，在原订单的结算日或其后的下一个结算日。请把这一列与上文的 Event Type 表配合使用，来核对某一具体的 CHARGEBACK 行。
为什么 Dispute Amount 和持卡人争议的金额不一样？
因为它们是两个不同的数字，Portal 展示给您的是您这一侧的数字。
支付侧发起的金额以原交易的支付币种计价。您看到的 Dispute Amount——也就是实际从您账上扣除的金额——是商户份额，以订单币种表示：
- 原支付中任何买家侧手续费由 Waffo 承担，而不是由您承担，并且不计入您的可争议余额。
- 您在争议金额中的份额，按您在买家支付金额中所占的比例计算，任何余数由 Waffo 承担。
- 该份额换算为订单币种后向下取整（FLOOR）到 2 位小数，因此该数字永远不会向不利于您的方向进位。不足一分的余数留给 Waffo。
- 在跨币种订单上，您的
Dispute Amount不会等于支付侧报出的数字，这个差异不是错误。 - 如果订单已经部分或全部退款，您剩余的可争议余额会更低，您的份额以此为上限。
- 您的
Dispute Amount永远不会超过订单金额。 - 如果持卡人只争议订单的一部分，案件上的
amount可能小于原交易金额。个别渠道支持这种部分拒付，Waffo 按渠道拒付结算金额占原结算金额的比例折算争议金额；无法折算或折算结果超过订单金额时，按全额入案。多数案件的amount等于原交易金额。
我的拒付手续费是什么币种？不是 USD。
拒付手续费币种来自您的商户配置，而不是全局默认值，并且会随feeAmount 一起以 feeCurrency 返回在案件上。它不保证与您的结算币种一致，也不保证是 USD。
当手续费币种与您的结算币种不同时，手续费会在结算时按该次结算的结算侧汇率换算为结算币种——与该次结算的其余部分使用相同的汇率基准，而不是开案当天锁定的汇率。两个币种相同时不发生换算。
因此，如果您的对账单显示了一笔您未预料到的币种的拒付手续费，那是您配置的手续费币种体现出来了。手续费金额本身是合同条款——见
拒付与争议 FAQ。
怎么找出快要到期的案件？
拒付列表顶部有 New Today（说明：过去 24 小时内创建）、Expiring Soon（说明：48 小时内到期）、Action Required（说明：等你响应）三张计数卡片，仅显示数量，点击不会筛选列表；Portal 预设的即将到期范围为证据截止时间在 3 天内；拒付和客户争议两个列表都可以按 Expiry Datetime 范围筛选，客户争议列表还有 Expire Status 筛选。这是按截止时间分拣的受支持方式；每个案件仍带有自己的expiryDateTime，对单个案件而言该值是权威的。
证据截止时间过了会怎样？
两种案件类型的表现不同，这也是二者之间最常被误读的差异：
因此，过期的客户争议是一次提醒，而不是关上的门：请提交迟到的材料并继续处理案件。过期的拒付则是败诉。当您在时间压力下给队列排优先级时，拒付的截止时间才是硬性的。
每个案件的时限按渠道规则确定，并以
expiryDateTime 随案件送达。它是 Waffo 给你的处理截止时间，可能早于卡组织或渠道侧的截止时间。没有统一的 Waffo 全局时限，也不是从交易日期推算的，因此请始终逐案读取该值而不要自行计算。
每日争议报告里的 Alert Status 取值是什么意思？
如果您开通了拒付预警，每日争议报告会带一个预警附件。Alert Status 是预警案件的整体阶段：
MANUAL PROCESSING 不是指”由您人工处理”。 这是该报告中最常被误读的一个值：它表示 Waffo 把该案件从自动化路径中拿出来了。如果确实需要您做什么，会直接联系您。
附件报告的是预警案件的阶段及其退款；它不会展示 MANUAL PROCESSING 案件背后的内部处理步骤，因此除了”非自动化，正在处理中”之外，无需对该值做更多解读。
Refund Status 是什么？Alert ID 长什么样？
同一附件中的 Refund Status 只跟踪由预警触发的那笔退款：
FAILED 的退款并不表示预警被忽略了——这正是会被人工接手的情况，所以 MANUAL PROCESSING 和 FAILED 退款经常出现在同一行。
Alert ID 的格式类似 CBA-00-20251125-00003：固定的 CBA 前缀、一个两位数字段、日期，以及一个序号。就某个具体预警联系客服时，请引用完整字符串。当预警与订阅相关时，附件中还会带有订阅 id。
预警对某笔订单完成退款后，您自己对该订单发起的退款请求会被拒绝并返回 A0039——其含义以及预警费用如何计费，见拒付与争议 FAQ。