整个流程从头到尾是什么样的？
整个流程是在你的浏览器会话中执行的 Portal 功能；由 API key 签名的集成 API 上
没有批量端点——集成场景请改用单笔退款 API。确认后会生成一个
退款批次 ID，格式为
BRP + MID + YYYYMMDD + 6 位当日序号，例如
BRP<你的商户 ID>20260225000001；批次的批次名称就是你上传的文件名，所以请给文件
起一个以后能认出来的名字。
文件必须是什么样的？
硬性限制：仅限
.csv，最大 2 MB，最多 2,000 条记录，非空且可解析——Portal 在上传前
检查扩展名和大小，服务端会再检查一次。有两点经常让人中招：删除
示例行（带有模板示例订单 ID 的行会在其他任何检查之前单独被拒绝），以及
每个文件只能一种币种。
为什么我的整个文件都被拒绝了？
上传校验是全有或全无的：不会创建任何内容，Portal 会以行、字段、 消息的形式列出有问题的行。检查按固定顺序运行，这也是为什么你通常一次只看到一类错误：- 文件级检查——格式、大小、是否为空、重复内容、是否已有批次正在进行中。
- 示例行检查；如果触发，它会是唯一返回的错误。
- 逐行检查——订单在你的 MID 下存在、文件内订单不重复、金额 > 0、币种有效、 一致、且等于订单的币种。
- 每行的单笔退款前置条件——订单已支付且可退款、没有正在进行中的退款、在 退款窗口期内、金额在剩余可退金额之内、没有争议锁定（退款 FAQ 对每一项都有说明）。
- 批次余额检查，仅当每一行都通过时才执行——文件的总额必须能被单笔退款所使用的同一个退款 资金来源覆盖，否则你会收到一个没有行号的批次级错误（“Insufficient merchant refund account capacity for batch refund”）。
为什么我无法上传——重复文件，还是有批次正在进行中？
重复检测基于文件内容而非文件名，范围限定在你的 MID 内。当 较早的上传仍在等待确认时重新上传相同内容，会返回同一个待确认的上传，这样你可以重新打开确认 对话框；一旦已经从该内容创建了批次，该内容就会被永久拒绝——要重试失败的 行请构建一个新文件，任何改动（哪怕是原因文本）都会使其成为新文件。已通过校验的上传如果搁置不管也会过期： 之后再确认会失败并提示 File token is invalid or expired，此时需要重新上传。 另外，只要你任何一个批次中的任何一笔退款仍在进行中，上传和确认都会被拒绝（“You have a batch refund in progress. Please wait for it to complete.”），所以请把大批量操作规划为文件队列；通过 API 发起的单笔 退款不受此限制。而且由于确认时会重新校验每一行，一个在确认对话框中搁置期间情况发生了变化的批次 ——某订单在别处被退款、窗口期关闭、余额变动——会在 确认时以第一个有问题行的消息失败，而不是创建一个部分无效的批次。批次状态分别是什么意思？
状态由行计数推导而来，而不是单独跟踪，所以随着各行落定它会自行变化。
每个批次显示总数 / 成功数 / 失败数 / 处理中数：失败数包括在提交时校验
失败的行，处理中数是尚未开始的行。一行出错不会阻止整个批次——各行
独立处理，这正是
PARTIAL_SUCCESS 的含义，而且批次没有重试操作：把失败的
行放进新文件，或者逐笔退款。
我在哪里能看到哪些行失败了以及为什么？
点击批次上的详情：它会打开退款 Tab，并按该退款批次 ID 预先筛选，同时带上批次 页面的日期范围。此时每笔退款就是一条普通记录——其详情页显示退款批次 ID，当状态为 退款失败时显示失败原因。退款 Tab 也有退款批次 ID 列和筛选项， 所以你可以直接到达同一视图。 批次列表导出（Batch_Refunds_<timestamp>.csv）是批次级汇总——ID、名称、金额、币种、
状态、四个计数、操作人、创建和更新时间——不包含逐行失败原因；
其中的时间使用你浏览器报告的 UTC 偏移。列表本身可按退款批次 ID、状态、币种
和创建时间筛选，打开时默认显示最近三个月。极少数情况下某行失败得太早以至于没有创建退款
记录：它仍计入失败数，但在退款 Tab 里没有可打开的内容——对于这类情况请带上
退款批次 ID 联系支持。
这与单笔退款 API 是什么关系？
同一个引擎，不同的入口：生命周期、账户选择和结算处理完全相同。有两个实际 差异。退款请求 ID——批次行会得到一个你看不到的系统生成 ID，所以请在 Portal 中按退款 批次 ID 或退款订单 ID 跟踪它们，而不是按你自己的参考号。通知——批次行不携带 逐行的通知 URL，所以退款通知会发到你账户配置的默认退款通知 URL； 如果没有配置，批次行不会发送任何Webhook 通知，Portal 是你唯一的查看渠道。文件一直失败？联系支持，附上文件，如果已创建批次，请附上退款批次 ID。