截至2026年4月,您现在可以在GraphQL管理API中使用SubscriptionBillingAttemptState字段。这个新字段用判别联合模式取代了多个松散类型的可空字段,从而提升了API的易用性和自文档化能力。
| 已弃用字段 | 新等效项 | 备注 |
|---|---|---|
| errorCode | FailedState.error.code | 错误代码现分为支付、库存、常规和意外错误四类 |
| 错误信息 | FailedState.error.message | 显式消息现在仅出现在 UnexpectedError 中;其他类型使用类型化代码 |
| nextActionUrl | ActionRequiredState.action.nextActionUrl | 现在还包含状态(OFF_SESSION_REJECTED / ON_SESSION_CHALLENGED) |
| 订单 | SuccessState.order | 相同的 Order 类型,限定于成功状态 |
| 相同订单类型,限定为成功状态 | FailedState.error | 由类型化的 SubscriptionBillingAttemptError 联合类型替换 |
| ready | PendingState.processing | 不再使用布尔值,而是检查状态是否为 PendingState |
有关SubscriptionBillingAttemptState模式的详细信息,请参阅文档。

