Represents the user's purchase intent.
An IntentMandate captures what the user wants to buy in natural language, along with any constraints or preferences they have specified.
user_cart_confirmation_required: boolean
If false, the agent can make purchases on the user's behalf once all purchase conditions are satisfied.
When true, the user must explicitly confirm each cart before purchase. When false, the agent has permission to complete purchases automatically that match the intent and satisfy all specified conditions.
natural_language_description: string
The natural language description of the user's intent, generated by the shopping agent and confirmed by the user.
This should be a clear, specific description of what the user wants to purchase, written in natural language.
merchants: readonly string[]
Merchants allowed to fulfill the intent.
If not set, the shopping agent can work with any suitable merchant. When specified, restricts the agent to only shop with the listed merchants.
skus: readonly string[]
A list of specific product SKUs.
If not set, any SKU is allowed that matches the intent. When specified, restricts the agent to only purchase the exact SKUs listed.
requires_refundability: boolean
If true, items must be refundable.
When set to true, the agent will only consider items that have a refund policy. This provides additional protection for the user.
intent_expiry: string
When the intent mandate expires, in ISO 8601 format.
After this time, the intent is no longer valid and should not be used to make purchases.