UCP Checker

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.

Free forever No spam Unsubscribe anytime

View a sample report →

Weekly UCP Report
Issue #50 · Sep 14, 2026
+664
new verified stores
Verified rate
Latest spec
Cart capability