WarrantyRegistration

A WarrantyRegistration represents the binding relationship between a warranty plan and an order item, including plan status, benefit quantities, and related metadata.

A WarrantyRegistration represents the binding relationship between a warranty plan and an order item, including plan status, benefit quantities, and related metadata.

id
string

The unique identifier of the warranty registration.

registration_number
string or null

The external registration number, if one exists.

plan_name
string

The plan name shown to merchants and shoppers.

status
string

The current registration status.

Allowed values:
validinvalidexpired
invalidated_at
string<date-time> or null

The date and time, formatted in ISO 8601, when the warranty registration was invalidated.

Example:
2024-09-27T10:45:30Z
invalidated_reason
string or null

A free-form reason describing why the warranty registration was invalidated.

expired_at
string<date-time> or null

The date and time, formatted in ISO 8601, when the warranty registration expires. Null means the plan does not expire.

Example:
2024-09-27T10:45:30Z
benefits
object

The benefits included in the warranty registration.

repair_item
Benefit

A benefit object containing the configured total quantity and the remaining quantity calculated by the system.

send_repair_kit
Benefit

A benefit object containing the configured total quantity and the remaining quantity calculated by the system.

replace_item
Benefit

A benefit object containing the configured total quantity and the remaining quantity calculated by the system.

Example
preparing...