Help for owners
I refunded a customer in PayPal but my system still shows the sale
Short answer
A refund in PayPal is its own record with its own status, and your system only learns about it if it listens for PayPal's refund event or reads the payment again. A refund can also be pending or failed. Check the refund's status in PayPal first, then how your system is told.
Does this sound like your situation?
- The customer was refunded, but my order still shows as paid.
- Stock or credits were not returned after a refund.
- My books show the full sale, and PayPal shows a refund.
- A partial refund shows as a full one, or the other way round.
- Refunds made in PayPal's own screens are missing, but refunds made from my admin are fine.
Why does this happen?
A refund is a separate record with a status
PayPal records a refund against a captured payment, and the refund has its own status: cancelled, failed, pending or completed. A pending or failed refund can carry a reason, for which PayPal lists ECHECK.
Confirmed by developer.paypal.com
The original payment changes status too
A captured payment can be completed, partially refunded or refunded. A system that only stores completed will not notice a partial refund.
Confirmed by developer.paypal.com
Your system learns through an event
PayPal has an event for a refunded capture, sent when a merchant refunds a payment capture. If your listener is not subscribed to it, or fails to handle it, a refund made outside your system never arrives.
Confirmed by developer.paypal.com
Missed events are only retried for a while
If your listener does not return a success status, PayPal retries up to 25 attempts over three days and then marks the event Failed. You can resend it from the Webhook Events dashboard.
Confirmed by developer.paypal.com
Refunds can be made through the API
PayPal's Payments API has a call that refunds a captured payment by its ID. A refund your own code makes can look different from one made by hand, so each path needs handling.
Confirmed by developer.paypal.com
What can I do about it today?
- Look at the refund in PayPalCheck that its status is completed and note whether it is full or partial. A pending refund has not finished.
- Do not refund againBefore issuing another, compare the PayPal activity with your order. Two refunds for one sale are hard to get back.
- Fix the order record by hand, once, with a noteIf the customer is clearly refunded, mark the order accordingly and write the PayPal reference in the note, so the books and stock follow.
- Make a listList refunds made in PayPal in the last few weeks and mark which ones your system missed. A pattern, such as all manual refunds, points to the cause.
- Tell your accountantIf refunded sales were already counted as income, they will need a correction.
- Ask your developer about the refund eventAsk whether the system listens for PayPal's refunded-capture event.
When should I bring someone in?
- Refunds made inside PayPal never reach your orders, stock or books.
- Partial refunds are handled wrongly.
- You issue refunds through your own admin and the two sides disagree.
How do I handle it?
- Compare both sidesI match PayPal's refund records with your orders and split the misses by how the refund was made.
- Check the listenerI confirm which events your site subscribes to and that the refund event is handled and its replies are successful.
- Handle full and partial refundsI make sure amounts are applied to the right order lines, using the statuses PayPal documents on the payment and the refund.
- Make it safe to repeatThe same event can arrive twice, so each refund is applied once, keyed on the PayPal reference.
- Repair historyI correct the past misses from PayPal's records, with a log, and a note for your accountant.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Does a refund in PayPal always tell my site?
Only if your site is subscribed to PayPal's refund event and handles it. PayPal sends the event when a merchant refunds a capture.
Why is a refund still pending?
PayPal records a reason on pending refunds; the one it lists is ECHECK. The refund finishes on PayPal's side, so I cannot give a time.
Can I pull missed refunds later?
Yes, the refund and the payment can be read again by ID through the Payments API, and failed events can be resent for a limited time.
Will my books fix themselves?
Not unless something is moving the refund into them. That step needs checking separately.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.