request_return_or_refund
Opens a return or refund case on an order, on behalf of the consumer. Input: orderId (the identifier returned by complete_checkout in order.id; the transaction id and the payment id are also accepted), type (RETURN | REFUND_ONLY | PARTIAL_REFUND | EXCHANGE), reason, optional lineItems[] and requestedRefundAmount. The case is authorised here and fulfilled by the merchant: the response says so. Requires the mcp:returns:initiate scope.
Schema
Input Schema
{
"type": "object",
"strict": true,
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"properties": {
"type": {
"enum": [
"RETURN",
"REFUND_ONLY",
"EXCHANGE",
"PARTIAL_REFUND",
"CHARGEBACK"
],
"type": "string"
},
"reason": {
"enum": [
"DAMAGED_GOODS",
"SERVICE_NOT_DELIVERED",
"ITEM_NOT_AS_DESCRIBED",
"WRONG_ITEM",
"ITEM_NOT_RECEIVED",
"DUPLICATE_CHARGE",
"AGENT_ERROR",
"EXCEEDS_INTENT_MANDATE",
"USER_CHANGED_MIND",
"OTHER"
],
"type": "string"
},
"agentId": {
"type": "string"
},
"orderId": {
"type": "string"
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cid": {
"type": "string"
},
"type": {
"type": "string"
},
"digest": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
},
"lineItems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string"
},
"name": {
"type": "string"
},
"itemReason": {
"enum": [
"DAMAGED_GOODS",
"SERVICE_NOT_DELIVERED",
"ITEM_NOT_AS_DESCRIBED",
"WRONG_ITEM",
"ITEM_NOT_RECEIVED",
"DUPLICATE_CHARGE",
"AGENT_ERROR",
"EXCEEDS_INTENT_MANDATE",
"USER_CHANGED_MIND",
"OTHER"
],
"type": "string"
},
"refundAmount": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"currency": {
"type": "string"
}
}
},
"itemCondition": {
"type": "string"
},
"returnQuantity": {
"type": "integer"
},
"itemReasonDetail": {
"type": "string"
}
}
}
},
"reasonDetail": {
"type": "string"
},
"cartMandateId": {
"type": "string"
},
"replacementSku": {
"type": "string"
},
"intentMandateId": {
"type": "string"
},
"ap2SchemaVersion": {
"type": "string"
},
"paymentMandateId": {
"type": "string"
},
"existingDisputeId": {
"type": "string"
},
"igfsTransactionId": {
"type": "string"
},
"preferredReturnMethod": {
"type": "string"
},
"requestedRefundAmount": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"currency": {
"type": "string"
}
}
},
"returnShippingAddress": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"streetAddress": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"naturalLanguageDescription": {
"type": "string"
}
},
"description": "Request payload"
}
}
}
Verified Stores
1
Member Stores
Stores exposing the request_return_or_refund tool
Weekly UCP Report
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.
Weekly UCP Report
Issue #50 · Sep 14, 2026
+664
new verified stores
Verified rate
Latest spec
Cart capability
