Update dispute status

Important: This method is for sandbox use only.

Updates the status of a dispute, by ID, from UNDER_REVIEW to either:

WAITING_FOR_BUYER_RESPONSE
WAITING_FOR_SELLER_RESPONSE

This status change enables either the customer or merchant to submit evidence for the dispute. To make this call, the dispute status must be UNDER_REVIEW and require-evidence link should be available in the HATEOAS links of the show dispute details response. Specify an action value in the JSON request body to indicate whether the status change enables the customer or merchant to submit evidence:

If `action` is	The `status` updates to
`BUYER_EVIDENCE`	`WAITING_FOR_BUYER_RESPONSE`
`SELLER_EVIDENCE`	`WAITING_FOR_SELLER_RESPONSE`

Authorization

AuthorizationBearer <token>

Oauth 2.0 authentication

In: header

Scope: https://uri.paypal.com/services/disputes/update-seller

Path Parameters

id*string

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

Match^[A-Za-z0-9-]+$

Length1 <= length <= 255

Header Parameters

Content-Type*string

Content type of the request payload.

Match\w+\/[-+.\w]+

Length1 <= length <= 255

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://api-m.paypal.com/v1/customer/v1/customer/disputes/string/require-evidence" \  -H "Content-Type: string" \  -H "Content-Type: application/json" \  -d '{    "action": "BUYER_EVIDENCE"  }'

{
  "links": [
    {
      "href": "string",
      "rel": "string",
      "method": "GET",
      "title": "string",
      "mediaType": "string",
      "encType": "application/json",
      "schema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      },
      "targetSchema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      }
    }
  ]
}

{
  "name": "string",
  "message": "string",
  "debug_id": "string",
  "information_link": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string",
      "links": [
        {
          "href": "string",
          "rel": "string",
          "method": "GET",
          "title": "string",
          "mediaType": "string",
          "encType": "application/json",
          "schema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          },
          "targetSchema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          }
        }
      ]
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string",
      "method": "GET",
      "title": "string",
      "mediaType": "string",
      "encType": "application/json",
      "schema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      },
      "targetSchema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      }
    }
  ]
}

{
  "name": "string",
  "message": "string",
  "debug_id": "string",
  "information_link": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string",
      "links": [
        {
          "href": "string",
          "rel": "string",
          "method": "GET",
          "title": "string",
          "mediaType": "string",
          "encType": "application/json",
          "schema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          },
          "targetSchema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          }
        }
      ]
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string",
      "method": "GET",
      "title": "string",
      "mediaType": "string",
      "encType": "application/json",
      "schema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      },
      "targetSchema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      }
    }
  ]
}

{
  "name": "string",
  "message": "string",
  "debug_id": "string",
  "information_link": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string",
      "links": [
        {
          "href": "string",
          "rel": "string",
          "method": "GET",
          "title": "string",
          "mediaType": "string",
          "encType": "application/json",
          "schema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          },
          "targetSchema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          }
        }
      ]
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string",
      "method": "GET",
      "title": "string",
      "mediaType": "string",
      "encType": "application/json",
      "schema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      },
      "targetSchema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      }
    }
  ]
}

{
  "name": "string",
  "message": "string",
  "debug_id": "string",
  "information_link": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string",
      "links": [
        {
          "href": "string",
          "rel": "string",
          "method": "GET",
          "title": "string",
          "mediaType": "string",
          "encType": "application/json",
          "schema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          },
          "targetSchema": {
            "additionalItems": {},
            "dependencies": {},
            "items": {},
            "patternProperties": {},
            "properties": {},
            "allOf": [
              {}
            ],
            "anyOf": [
              {}
            ],
            "oneOf": [
              {}
            ],
            "not": {},
            "links": [
              {}
            ],
            "fragmentResolution": "string",
            "media": {
              "type": "string",
              "binaryEncoding": "string"
            },
            "pathStart": "http://example.com"
          }
        }
      ]
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string",
      "method": "GET",
      "title": "string",
      "mediaType": "string",
      "encType": "application/json",
      "schema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      },
      "targetSchema": {
        "additionalItems": {},
        "dependencies": {},
        "items": {},
        "patternProperties": {},
        "properties": {},
        "allOf": [
          {}
        ],
        "anyOf": [
          {}
        ],
        "oneOf": [
          {}
        ],
        "not": {},
        "links": [
          {}
        ],
        "fragmentResolution": "string",
        "media": {
          "type": "string",
          "binaryEncoding": "string"
        },
        "pathStart": "http://example.com"
      }
    }
  ]
}

If action is

The status updates to

BUYER_EVIDENCE

WAITING_FOR_BUYER_RESPONSE

SELLER_EVIDENCE

WAITING_FOR_SELLER_RESPONSE

Header Parameters

Content-Type*string

Content type of the request payload.

Match\w+\/[-+.\w]+

Length1 <= length <= 255

TypeScript Definitions

Use the request body type in TypeScript.

action*string

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

Match^[0-9A-Z_]+$

Length1 <= length <= 255

Value in"BUYER_EVIDENCE" | "SELLER_EVIDENCE"

curl -X POST "https://api-m.paypal.com/v1/customer/v1/customer/disputes/string/require-evidence" \ -H "Content-Type: string" \ -H "Content-Type: application/json" \ -d '{ "action": "BUYER_EVIDENCE" }'

{ "links": [ { "href": "string", "rel": "string", "method": "GET", "title": "string", "mediaType": "string", "encType": "application/json", "schema": { "additionalItems": {}, "dependencies": {}, "items": {}, "patternProperties": {}, "properties": {}, "allOf": [ {} ], "anyOf": [ {} ], "oneOf": [ {} ], "not": {}, "links": [ {} ], "fragmentResolution": "string", "media": { "type": "string", "binaryEncoding": "string" }, "pathStart": "http://example.com" }, "targetSchema": { "additionalItems": {}, "dependencies": {}, "items": {}, "patternProperties": {}, "properties": {}, "allOf": [ {} ], "anyOf": [ {} ], "oneOf": [ {} ], "not": {}, "links": [ {} ], "fragmentResolution": "string", "media": { "type": "string", "binaryEncoding": "string" }, "pathStart": "http://example.com" } } ] }

{ "name": "string", "message": "string", "debug_id": "string", "information_link": "string", "details": [ { "field": "string", "value": "string", "location": "body", "issue": "string", "description": "string", "links": [ { "href": "string", "rel": "string", "method": "GET", "title": "string", "mediaType": "string", "encType": "application/json", "schema": { "additionalItems": {}, "dependencies": {}, "items": {}, "patternProperties": {}, "properties": {}, "allOf": [ {} ], "anyOf": [ {} ], "oneOf": [ {} ], "not": {}, "links": [ {} ], "fragmentResolution": "string", "media": { "type": "string", "binaryEncoding": "string" }, "pathStart": "http://example.com" }, "targetSchema": { "additionalItems": {}, "dependencies": {}, "items": {}, "patternProperties": {}, "properties": {}, "allOf": [ {} ], "anyOf": [ {} ], "oneOf": [ {} ], "not": {}, "links": [ {} ], "fragmentResolution": "string", "media": { "type": "string", "binaryEncoding": "string" }, "pathStart": "http://example.com" } } ] } ], "links": [ { "href": "string", "rel": "string", "method": "GET", "title": "string", "mediaType": "string", "encType": "application/json", "schema": { "additionalItems": {}, "dependencies": {}, "items": {}, "patternProperties": {}, "properties": {}, "allOf": [ {} ], "anyOf": [ {} ], "oneOf": [ {} ], "not": {}, "links": [ {} ], "fragmentResolution": "string", "media": { "type": "string", "binaryEncoding": "string" }, "pathStart": "http://example.com" }, "targetSchema": { "additionalItems": {}, "dependencies": {}, "items": {}, "patternProperties": {}, "properties": {}, "allOf": [ {} ], "anyOf": [ {} ], "oneOf": [ {} ], "not": {}, "links": [ {} ], "fragmentResolution": "string", "media": { "type": "string", "binaryEncoding": "string" }, "pathStart": "http://example.com" } } ] }

Update dispute status

200application/json

400application/json

422application/json

500application/json

defaultapplication/json

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

Update dispute status

200application/json

400application/json

422application/json

500application/json

defaultapplication/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`