Customer Disputes - PayPal Developer

HomeOnlineIn-PersonMultiparty3rd PartyPayoutsDisputesReportsIdentityDocs ArchiveVideoOverview

• Integration Guide
• Test Disputes
• Acceptance Test Criteria
• FAQs
• Webhooks
• Reference

Disputes/ Overview OpenAI iconAsk ChatGPT Customer disputesDOCSCURRENT

Last updated: May 8th, 3:42pm

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

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.

Method	Resolution Center Actions
List disputes	Go to Case summary. Select Open Cases.
Show dispute details	Under Case ID, select **+** to show the transaction ID, date opened, and other details.
Send message to other party	On the case summary page, click View. Select Message, enter the message details, and click Send.
Make an offer to resolve a dispute	On the case summary page, click View. Select Make an offer. Select which offer to make: Full refund offer with item return, Partial refund offer, Replacement offer.
Escalate dispute to a claim	On the Escalate to PayPal page, enter the detailed description, and select Send.
Provide evidence	Click Enter tracking information and order status. 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

Enable Disputes and use the API actions

Manually manage disputes

ReferencePayPal.comPrivacyCookiesSupportLegalContact

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

AcceptDeclineClose