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+):