Dispute an order
shop.order.disputeOpen a dispute for a paid order to request a refund for not received, not as described, duplicate, or canceled recurring charges; merchant has 7 days to answer.
Instructions
Open a dispute on an order you paid (PAID..DELIVERED). reason_code: not_received, not_as_described, duplicate, canceled_recurring, agent_error, other; note up to 1000 characters. The order becomes DISPUTED and the merchant has 7 days to answer (by refunding it); an unanswered dispute expires and counts in the merchant's reputation, which can suspend its quotes. A verified refund resolves the dispute. One open dispute per order; another identity's order is 404.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"order_id": "<order_id>",
"reason_code": "<reason_code>"
},
"name": "shop.order.dispute"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| order_id | Yes | ||
| reason_code | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | ||
| due_at | Yes | ||
| status | Yes | ||
| order_id | Yes | ||
| dispute_id | Yes | ||
| reason_code | Yes |