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.
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\"."
}
}
}Stores exposing the keepcard_check_return_eligibility tool
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.