keepcard_check_return_eligibility
Check whether a customer order is eligible for a return. If the customer only says they want to return an order and has not given an order number yet, do not call this tool yet — ask for the order number first. Do not look up orders by recency. If the customer has a linked identity (OAuth), source the email from their identity profile or from trusted session context and omit the email argument. Only prompt for email when the tool returns a missing_params or invalid_params error and no trusted email is already available. Returns eligibility, session_id for follow-up steps, customer_message, and order summary. Always call this first once a real order number is available.
Each store has its own status page. To find more, search the directory.
Input schema
{
"type": "object",
"required": [
"order_id"
],
"properties": {
"email": {
"type": "string",
"description": "Exact email address used at checkout. When the customer has a linked identity (OAuth), omit this field \u2014 the system resolves the email silently from the bearer token. Only ask the customer for their email when the tool returns a missing_params or invalid_params error. Do not invent example emails such as [email protected]."
},
"order_id": {
"type": "string",
"description": "The real order number provided by the customer (for example \"1042\" or \"#1042\"). Always ask the customer for their order number; do not infer it from order history, do not use example order numbers, and do not pass placeholders or descriptive strings such as \"order_number_provided_by_customer\"."
}
}
}
