Skip to main content
POST
/
v1
/
customer
/
disputes
/
{id}
/
require-evidence
Update dispute status
curl --request POST \
  --url https://api-m.sandbox.paypal.com/v1/customer/disputes/{id}/require-evidence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "links": [
    {
      "href": "<string>",
      "rel": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Oauth 2.0 authentication

Path Parameters

​
id
string
required

The ID of the dispute for which to provide the supporting information.

Required string length: 1 - 255
Pattern: ^[A-Za-z0-9-]+$

Body

Sandbox only. Updates the state of a dispute, by ID, to either WAITING_FOR_BUYER_RESPONSE or WAITING_FOR_SELLER_RESPONSE. This state change enables either the customer or merchant to submit evidence for the dispute. Specify an action value in the JSON request body to indicate whether the state change enables the customer or merchant to submit evidence.

​
action
enum<string>
required

The action. Indicates whether the state change enables the customer or merchant to submit evidence.

Available options:
BUYER_EVIDENCE,
SELLER_EVIDENCE
Required string length: 1 - 255
Pattern: ^[0-9A-Z_]+$

Response

A successful request returns the HTTP 200 OK status code and a JSON response body that includes a link to the dispute.

The subsequent action.

​
links
Link Description · object[]
read-only

An array of request-related HATEOAS links.

Required array length: 1 - 10 elements