Make offer to resolve dispute

Makes an offer to the other party to resolve a dispute, by ID. To make this call, the stage in the dispute lifecycle must be `INQUIRY`. If the customer accepts the offer, PayPal automatically makes a refund. Allowed offer_type values for the request is available in dispute details allowed response options object.

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/make-offer" \  -H "Content-Type: string" \  -H "Content-Type: application/json" \  -d '{    "note": "string",    "offer_type": "REFUND"  }'

{
  "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"
      }
    }
  ]
}

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.

note*string

The merchant's notes about the offer.

Match^(.|\r?\n)*$

Length1 <= length <= 2000

offer_amount?

The amount proposed to resolve the dispute.

return_shipping_address?Deprecated

The return address for the item. Required when the customer must return an item to the merchant for the MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED dispute reason, especially if the refund amount is less than the dispute amount.

return_shipping_address_info?

Merchant provided information regarding return shipping address.

invoice_id?string

The merchant-provided ID of the invoice for the refund. This optional value maps the refund to an invoice ID in the merchant's system.

Match^.*$

Length1 <= length <= 127

offer_type*Offer Type

The merchant-proposed offer type for the dispute.

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

Length1 <= length <= 255

Value in"REFUND" | "REFUND_WITH_RETURN" | "REFUND_WITH_REPLACEMENT" | "REPLACEMENT_WITHOUT_REFUND"

curl -X POST "https://api-m.paypal.com/v1/customer/v1/customer/disputes/string/make-offer" \ -H "Content-Type: string" \ -H "Content-Type: application/json" \ -d '{ "note": "string", "offer_type": "REFUND" }'

{ "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" } } ] }

Make offer to resolve dispute

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

Make offer to resolve dispute

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`