Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

PayPal says the payment worked but my site never gets notified

Short answer

PayPal sends a webhook or IPN message to a URL on your server and expects a success reply. If the listener is unreachable, subscribed to the wrong app or returns an error, PayPal retries for a limited time and then marks the delivery failed. Check the delivery record in PayPal first, then your listener.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • Customers pay in PayPal but nothing happens on my site.
  • PayPal's webhook events page shows deliveries as failed.
  • It worked on the test site and stopped working after going live.
  • It stopped after a server, domain, firewall or security-plugin change.
  • Some events arrive and others, like refunds, never do.

Why does this happen?

  1. PayPal must get a success reply

    A webhook is an HTTPS POST that PayPal sends to your listener URL, and your endpoint has to answer with a 2xx status. Any other answer triggers retries, up to 25 attempts over three days, after which the event is marked Failed.

  2. Events only reach the app they come from

    You subscribe a URL to an app, and events arrive only for the app they originate from. Each app supports up to 10 URLs, and a URL can be limited to chosen event types. A listener on the wrong app, or not subscribed to the event, never sees it.

  3. Verification can reject real messages

    PayPal describes verifying that a message came from PayPal, either by checking its signature yourself or by sending the message, stored webhook ID and header information to PayPal's verify-signature endpoint. A wrong webhook ID or a changed body makes real events fail.

  4. IPN has its own setup

    With IPN, PayPal sends a form POST to the listener URL set in your account profile, and the listener must validate the message with PayPal. IPN has to be enabled in the account settings, and PayPal keeps resending a message until the listener acknowledges it, for up to 4 days.

  5. Delivery can be late even when it works

    PayPal says IPN delivery can be delayed by system load or connectivity problems, and that checkout should not wait for it.

What can I do about it today?

  1. Check which kind of message you useAsk your developer whether the site uses webhooks or IPN. They are set up in different places in PayPal.
  2. Look at PayPal's delivery recordIn the PayPal developer dashboard, open the Webhook Events page and see whether events show as delivered or failed. Do not delete the listener or events.
  3. Resend one eventPayPal lets you resend a failed event from the Webhook Events dashboard. Do this for one event, after your developer confirms the listener is ready.
  4. Ask what changedFind out whether the server, domain, certificate, firewall or security plugin changed around the time it stopped.
  5. Check live and test are not mixed upMake sure the listener is subscribed on the app that takes the real payments.
  6. List what is already out of syncNote payments PayPal completed that your site missed, with dates, so they can be repaired afterwards.

When should I bring someone in?

  • Events have been failing for days; PayPal stops retrying after three days.
  • You cannot say whether the site uses webhooks or IPN.
  • Messages arrive but your site rejects them.

How do I handle it?

  1. Prove the path with one eventI send a test event to the listener in the sandbox and watch whether it arrives, what the server answers and where it stops.
  2. Check reachabilityI check that the URL is public, answers over HTTPS and is not blocked by a firewall, redirect or security rule.
  3. Fix the answerThe listener must reply quickly with a 2xx and do slow work after replying; I also make its processing safe to repeat, since retries mean the same event can come twice.
  4. Fix verificationI check the stored webhook ID and the verification call against PayPal's documentation.
  5. Recover missed eventsI resend failed events while they can still be resent, and reconcile the rest against PayPal's transaction records.

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?

How long does PayPal keep retrying?

For webhooks, up to 25 attempts over three days; for IPN, a message is resent for up to 4 days until acknowledged.

Can I get a failed event again?

PayPal says you can resend a failed webhook event manually from the Webhook Events dashboard.

Do I need both webhooks and IPN?

Normally one. PayPal describes the NVP and SOAP APIs, which IPN belongs to, as legacy but still supported.

Why does it work on sandbox only?

PayPal says events only arrive for the app they originate from, so a URL has to be subscribed on the app that is actually taking the payments.

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.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.