stripe 争议（dispute）的状态由系统自动管理，开发者无法通过 api 手动修改 `status` 字段；唯一合法的更新操作是提交证据（`evidence`）、添加元数据（`metadata`）或触发提交动作（`submit: true`），状态变更将随之自动发生。
在 Stripe 的争议生命周期中，status 是一个只读、服务端自动计算的字段，它反映争议当前所处的业务阶段（如 warning_needs_response、warning_under_review、won 或 lost）。你不能像更新普通模型属性一样，通过 disputes->update() 直接设置 status —— 这正是你遇到 Received unknown parameter: status 错误的根本原因。
✅ 正确做法是：通过提交争议证据来推动状态流转。当争议处于 warning_needs_response 状态时，你需要：
- 上传并补充必要证据（如订单凭证、发货证明、客户沟通记录等）；
- 调用 update() 并设置 submit: true（显式提交，或依赖默认行为）；
- Stripe 收到提交后，会自动将状态升级为 warning_under_review（注意：文档中标准值为 warning_under_review，而非 warning_needs_review，请以最新 API 文档为准）。
以下是合规的 PHP 示例代码（使用 Stripe PHP SDK v10+）：
try {
$dispute = $stripe->disputes->update('du_1KDL6AAnDItLrqj23xPFWxoW', [
'evidence' => [
'product_description' => 'Premium SaaS subscription, billed monthly',
'receipt_email' => 'customer@example.com',
'shipping_tracking_number' => 'TRK123456789US',
],
'submit' => true, // 关键：触发提交，状态将自动变为 warning_under_review
]);
echo "Dispute submitted successfully. New status: " . $dispute->status;
// 输出示例：warning_under_review
} catch (\Stripe\Exception\InvalidRequestException $e) {
error_log("Stripe update failed: " . $e->getMessage());
// 处理证据缺失、格式错误等客户端异常
}⚠️ 注意事项：
- submit: true 是一次性操作：一旦提交，无法撤回，且后续再调用 update 时若重复提交将被忽略；
- 证据字段需符合 Stripe 证据要求（例如 receipt_email 必须与支付邮箱一致，shipping_tracking_number 需含有效物流信息）；
- 若未提供任何 evidence 字段但设置了 submit: true，Stripe 仍会提交空证据，可能导致争议败诉 —— 务必确保证据充分、真实、及时；
- 状态变更存在短暂延迟，建议通过 Webhook（事件 dispute.updated）监听最终状态，而非依赖 API 响应中的 status 值做即时判断。
? 总结：Stripe 的争议状态设计遵循“行为驱动状态”原则——你的操作（提交证据）才是状态跃迁的唯一动因。放弃手动赋值思维，聚焦于合规、完整、及时地提交证据，系统自会将 warning_needs_response 安全、准确地推进至 warning_under_review 及后续阶段。
