Open a dispute
open_disputeReport a problem with an order. not_received is allowed while the order is marked shipped. Other reasons require a delivered order waiting for confirmation. This records the issue, pauses the seller payout, and notifies ForthClear. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write). Sensitive: requires user approval each time.
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": "<reason>",
"description": "<description>",
"idempotency_key": "<idempotency_key>"
},
"name": "open_dispute"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Dispute reason. not_received is allowed while the order is shipped. The other reasons require delivered_pending_confirmation. | |
| order_id | Yes | ForthClear order id | |
| photo_urls | No | Optional evidence URLs | |
| description | Yes | Free-text description of the issue | |
| idempotency_key | Yes | Required. 8–200 characters (letters, digits, . _ : -). The same key returns the original result for 24 hours and is sent to Stripe as Idempotency-Key. | |
| requested_action | No | Resolution the buyer is requesting |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sla | Yes | ||
| status | Yes | ||
| message | Yes | ||
| success | Yes | ||
| order_id | Yes | ||
| opened_at | Yes | ||
| dispute_id | Yes | ||
| next_actions | Yes |