Customer disputes

Overview

DocsCurrentLast updated: March 16th 2023, @ 11:23:55 am


Not a developer? Manage disputes directly in the PayPal Resolution Center.Get Started

A dispute occurs when:

  • A customer has not received goods or services.
  • The received goods or services are not as described.
  • The customer needs more details, such as a copy of the transaction or a receipt.

How it works

A customer can file a case with PayPal through the Resolution Center to dispute the charge or ask their bank or credit card company to reverse it.

A charge reversal is also known as a chargeback.

Disputes in the PayPal Resolution Center

  1. The customer files a dispute directly with the seller or on PayPal's Resolution Center.
  2. The seller reviews the dispute and provides additional information.
  3. The customer is refunded if the dispute is settled in the customer's favor.

Disputes Flow Marketplace

Disputes through the bank or card issuer

  1. The customer files a dispute with the bank or card issuer.
  2. The dispute is created in PayPal.
  3. The seller reviews the dispute and provides additional information.
  4. The customer is refunded if the dispute is settled in the customer's favor.

Disputes Flow Bank

Customer workflow

In the Resolution Center, the customer selects the dispute from the following options:

  • I didn't receive an item I purchased
  • I received an item that's not as described
  • I want to report unauthorized activity
  • I have a billing issue

A dispute is created, and the Resolution Center prompts the customer to contact the seller about the problem.

Actions available with the Disputes API

You can also use the Disputes API to automate actions in the Resolution Center.

The following table shows the methods available as actions in the Resolution Center.

MethodResolution Center Actions
List disputes
  1. Go to Case summary.
  2. Select Open Cases.
Show dispute detailsUnder Case ID, select **+** to show the transaction ID, date opened, and other details.
Send message to other party
  1. On the case summary page, click View.
  2. Select Message, enter the message details, and click Send.
Make an offer to resolve a dispute
  1. On the case summary page, click View.
  2. Select Make an offer.
  3. Select which offer to make: Full refund offer with item return, Partial refund offer, Replacement offer.
Escalate dispute to a claimOn the Escalate to PayPal page, enter the detailed description, and select Send.
Provide evidence
  1. Click Enter tracking information and order status.
  2. Enter the information and click Submit.
You can provide more evidence by uploading files.
Accept claim To accept the claim, select I'll issue a refund to my customer and close this case.
Appeal dispute To appeal the dispute, select I disagree with the claim. I'd like to submit additional info.

Eligibility

Review the supported countries and currencies.

Dispute use cases

You can use the Disputes API to:

  • Automate handling large volumes of disputes.
  • Manage PayPal disputes from your internal dispute management tool instead of the PayPal Resolution Center.
  • Show open PayPal disputes to sellers in a shopping cart without providing management of the disputes.

How do you want to integrate?

Choose how to manage your disputes:

Use the Disputes APIUse the Resolution Center

Use the Disputes API

Enable Disputes and use the API actions

Use the Resolution Center

Manually manage disputes

Get startedGo to the Resolution Center