Skip to main content
POST
/
v1
/
customer
/
disputes
/
{id}
/
make-offer
Make offer to resolve dispute
curl --request POST \
  --url https://api-m.sandbox.paypal.com/v1/customer/disputes/{id}/make-offer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "note": "Offer refund with replacement item.",
  "offer_type": "REFUND_WITH_REPLACEMENT"
}'
{
  "links": [
    {
      "href": "<string>",
      "rel": "<string>",
      "method": "GET"
    }
  ]
}

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

Body

A merchant request to make an offer to resolve a dispute.

​
note
string
required

The merchant's notes about the offer.

Required string length: 1 - 2000
​
offer_type
enum<string>
required

The merchant-proposed offer type for the dispute.

Available options:
REFUND,
REFUND_WITH_RETURN,
REFUND_WITH_REPLACEMENT,
REPLACEMENT_WITHOUT_REFUND
​
offer_amount
object

The amount proposed to resolve the dispute.

​
return_shipping_address
object

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

​
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.

Required string length: 1 - 127

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[]

An array of request-related HATEOAS links.

Required array length: 1 - 10 elements