Skip to main content

Set up PayPal dispute management

Connect PayPal, enable the workflow, and validate the first case refresh.

Written by Mike Hammon

Validate the dispute connection and approval boundary

Annotated PayPal disputes inbox showing monitoring, approval, filters, and deadlines
  1. Connect every PayPal account that can receive this store's transactions.

  2. Open Disputes.

  3. Select Refresh from PayPal.

  4. Confirm Assisted dispute monitoring is On and Merchant approval required is visible.

  5. Check Cases monitored, Cases awaiting response, and Last checked.

  6. Open one case and verify the PayPal transaction, Shopify order, reason, lifecycle stage, deadline, evidence, activity, and available actions.

Required PayPal access

The connected account must own the disputed transaction and retain the PayPal dispute permissions granted during authorization. If cases stop refreshing after a password, permission, or security change, re-authorize that same payer in Settings.

Monitoring versus submission

Monitoring retrieves changes, deadlines, messages, evidence state, and the actions PayPal currently permits. It does not send a message, offer, evidence package, acceptance, return acknowledgement, escalation, supporting information, or appeal. An authorized merchant user must open an action, complete the required fields, and approve the final submission.

If no cases appear

  1. Clear search and return to the All tab.

  2. Confirm the receiving PayPal account is Active.

  3. Select Refresh from PayPal once.

  4. Check whether PayPal shows the case for that exact account.

  5. Record the dispute ID and last checked time before contacting support.

New cases and action changes appear only as PayPal makes them available.

Did this answer your question?