Working with PayPal?

PayPal silent after checkout? We fix it.

Most PayPal problems that reach us are not really about cards being declined. The buyer paid, PayPal says the money moved, and the store never heard about it. We find where the notification went and we make sure the next one lands.

  • Since 2015Fixing technology
  • FreeEstimates
  • US teamReal engineers

paypal-webhook.log

still failing

What it is

PayPal at a glance

PayPal Holdings, Inc. (NASDAQ: PYPL) is an online payment platform used by roughly 435 million active accounts worldwide. It was founded in 1998 out of Confinity and X.com, became part of eBay in 2002, and was spun back out as an independent public company in 2015.

Its product range covers Checkout buttons and smart checkout, Payouts, Subscriptions, Braintree (acquired in 2013), Venmo and Pay Later. Two API families live side by side: the older Classic stack built on NVP or SOAP with IPN for notifications, and the modern REST stack built on Orders v2 with Webhooks. The two do not share credentials, event shapes or verification flow, which is where a lot of the pain starts.

Type
Online payments
First released
1999
License
Proprietary SaaS
Maintained by
PayPal Holdings, Inc.
Typically used for
Card payments, PayPal wallet checkout, subscriptions, marketplaces, B2B invoicing

The honest version

PayPal pros and cons

No technology is all upside. This is where PayPal earns its place and where it tends to cause trouble.

Where PayPal is strong

  • Buyers already trust the buttonThe PayPal mark is one of the few checkout logos shoppers actively look for, which raises completion rates on sites they have never bought from before.
  • Helps on high-ticket ordersBuyer protection reassures customers spending real money, so conversion on four and five figure baskets is often noticeably better than card-only checkout.
  • Global reach in one accountA single merchant account takes payment in most currencies from most countries, without opening a local acquirer in each market.
  • Venmo and Pay Later includedUS buyers get Venmo as a wallet option and Pay Later as a buy-now-pay-later line, through the same integration as the regular button.
  • No card data on your serverThe sensitive details never touch your application, which keeps PCI scope small and audits short.
  • Subscriptions via Billing AgreementsRecurring charges run on PayPal's side, so renewals keep working even when a customer's card is replaced inside their PayPal wallet.

Where PayPal bites

  • Two API generations in parallelClassic NVP and SOAP with IPN still runs behind many older stores, while new work uses REST with Webhooks. Code written for one does not translate cleanly to the other.
  • IPN and Webhooks are easy to confuseThey solve the same problem with different payloads, different verification steps and different dashboards, and it is common to find a store wired up to the wrong one.
  • Accounts can be limited without much warningA risk review can freeze an entire balance while PayPal asks for documents, and cashflow stops until that review clears.
  • Disputes lean toward the buyerUnauthorised transaction and item-not-received claims are often decided in the customer's favour unless the merchant has very specific proof ready.
  • Cancellation flows leave your siteA subscriber cancels inside their PayPal account, not yours, which makes save offers and win-back prompts awkward to run.
  • Refunds blocked on low balanceIf the PayPal balance has already been swept to the bank, a refund can fail with insufficient funds until the account is topped up.
  • Docs lag behind the productNew fields and endpoints ship before the reference updates, so working examples often come from support tickets rather than the public docs.

Sound familiar?

Common PayPal problems we fix

The PayPal problems that bring people to us, and what you have once each one is fixed.

IPN delivery failed (HTTP 500 from merchant)

Orders paid for but never marked paid

PayPal collected the money and tried to tell the store, the store's listener threw an error, and the retry queue gave up before anyone noticed.

Every payment lands in the order

Webhook ID mismatch: verification failed

Webhooks arrive and get rejected

A webhook signed under one app ID is being verified against another, usually after a copy-paste from sandbox to live.

Verified against the right app

INSTRUMENT_DECLINED

Good buyers are being turned away

Smart checkout returning a decline for cards that work elsewhere, often down to AVS, 3-D Secure or a seller-protection rule set too tight.

Legitimate orders go through

ACCOUNT_LIMITATION: Account funds temporarily held

The balance is frozen

A risk review has locked the account and withdrawals are blocked until paperwork is submitted and accepted.

Documents in, limitation lifted

subscription renewal failed

Recurring payments quietly stop

Billing agreements cancel themselves after repeated funding failures and the customer is never prompted to update.

Dunning that reaches the buyer

REFUND_FAILED_INSUFFICIENT_FUNDS

A refund will not go through

The money has already been moved to the bank, so there is nothing left in the PayPal balance to send back.

Refund logic that tops up first

scope insufficient for /v2/payments/captures

A new endpoint returns 401

The REST app was created before the scopes it now needs existed, and nobody updated the app's permissions.

Scopes granted, token refreshed

PayPal Standard deprecated

Still running the old button

A legacy integration that relies on IPN and hosted buttons, which works today but is on borrowed time.

Moved onto Orders v2 cleanly

What we do

PayPal help, from checkout to chargeback

Call us for one failed webhook, or hand us the whole integration.

Rescue
Checkout broken, webhooks silent, or the account limited. We get payments flowing first and investigate second.
IPN and Webhooks
Tracing lost notifications, replaying missed events, and making verification strict so bogus ones never post.
Migrations
Moving from PayPal Standard and IPN onto Orders v2 with Webhooks, without losing historical subscriptions.
Disputes and limitations
Preparing evidence for claims, and working through the document requests that unlock a frozen balance.
Alongside other processors
Adding PayPal next to an existing card processor so the two never double-charge or disagree about status.
Managed Tech
Monitoring, alerting on failed events, and a team to call when something looks wrong.

How it works

From first message to fixed

  1. Look Free estimate

    Tell us what's going wrong. We look at it, then tell you plainly what's wrong and what it will cost.

  2. Fix

    We fix the cause, not the symptom. If something is down, getting it back up comes first.

  3. Harden

    Backups, monitoring, updates and access, so the same problem can't quietly come back.

  4. Hand back or stay on

    You get a plain-language write-up. Or we stay on for hosting, upkeep and new work.

Often found together

Running PayPal alongside something else?

We work on the whole stack, so the problem can be wherever it actually is.

Questions

PayPal questions

Something else? Call+1 737 727 7327

Why are PayPal IPN notifications not reaching our store?

The common reasons are a listener URL that now returns a 5xx or a redirect, TLS that PayPal will not negotiate any more, a firewall blocking PayPal's address ranges, or an IPN that is being sent to a sandbox endpoint while the payments are live. We replay the queue from the PayPal dashboard once the listener is answering correctly again.

Why did PayPal freeze our balance?

Most often it is a risk review triggered by a change in volume, a spike in disputes, or a mismatch between what the account was registered for and what is actually being sold. The balance usually releases once PayPal has the documents they ask for, and we help put that package together.

Can we migrate from PayPal Standard IPN to Webhooks?

Yes. We stand up a REST app alongside the existing integration, mirror events into both for a period so nothing is lost, then cut the store over once the new path has handled real orders cleanly. Existing subscriptions keep running throughout.

How do we add PayPal as a secondary option without breaking Stripe?

The two processors need separate order states and separate webhook listeners, with the order record holding which one owns the payment. Done that way they coexist cleanly and refunds always go back to the processor that took the money.

Why are PayPal subscription renewals failing?

Usually the funding source in the buyer's PayPal wallet has expired or been removed, and the billing agreement has been retrying quietly. We turn on dunning emails from PayPal, surface the problem inside your own account area, and give the customer a way to update without starting a brand new subscription.

How much does PayPal help cost?

Estimates are free. Share the merchant account details and the exact failure you see, and we come back with a scope before anything is touched.

Free estimate

PayPal giving you trouble?

Tell us what you're running and what's going wrong. A person reads it and comes back with an estimate.

  • No charge to find out what it will take
  • If it's urgent, say so

Replies come from a person. By sending, you authorize us to email you back. No marketing.