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.
1verified stores declare the request_return_or_refund tool
0%of the verified stores we check
By store platform
Custom or not identified 100%
By release
Each store has its own status page. To find more, search the directory.
Input schema
inputSchema
{
"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"
}
}
}