Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

PayPal payments stay pending and my orders never complete

Short answer

A PayPal payment can be pending for a reason PayPal records on the payment itself, such as a review, an eCheck or a verification step, and it can also be waiting on the buyer. Your site then needs to hear when it completes. Read the reason on the payment first, and check how your site gets the final status.

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

Does this sound like your situation?

  • The buyer paid, but my order stays on awaiting payment.
  • PayPal shows the payment as pending and I do not know why.
  • Some payments complete at once and others never do.
  • The customer was sent back to PayPal and nothing happened.
  • My system only changes the order when the customer returns to my site.

Why does this happen?

  1. The payment itself records a reason

    PayPal's Payments API gives a captured payment a status such as completed, pending, declined or failed, and a pending or denied payment carries a reason. The reasons it lists include PENDING_REVIEW, ECHECK, VERIFICATION_REQUIRED, TRANSACTION_APPROVED_AWAITING_FUNDING, RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION and DECLINED_BY_RISK_FRAUD_FILTERS.

  2. The buyer may still have to act

    In the Orders API an order cannot complete when the buyer has not approved it, or when PayPal needs the buyer to return and take action. The error names are ORDER_NOT_APPROVED and PAYER_ACTION_REQUIRED.

  3. Your site learns the result from a message

    PayPal sends events such as a capture moving to pending and a capture completing to your webhook listener. If those messages are not received or handled, an order stays pending even after PayPal completed it.

  4. The return page is not enough

    For the older notification method, PayPal advises that checkout should not wait for an IPN message, because delivery can be delayed by system load or connectivity problems. An order that depends only on that message or on the buyer returning can stick.

What can I do about it today?

  1. Open the payment in your PayPal accountLook at its status and any reason shown. Write it down with the order number. This tells you whether PayPal or your site is the one waiting.
  2. Do not ship or release goods on a pending paymentWait until the payment shows as completed in PayPal.
  3. Do not refund and re-chargeCancelling and asking the buyer to pay again can create a double payment. Contact the buyer only if PayPal's status says action is needed.
  4. Compare PayPal with your ordersList payments completed in PayPal whose orders still show pending. If there are many, the notification path is the likely cause.
  5. Ask your developer how orders are completedThe right answer is that the site reacts to PayPal's completion event, not only to the buyer returning.
  6. Keep screenshots of examplesA few examples with times make it much faster to find where the message was lost.

When should I bring someone in?

  • Completed PayPal payments are not completing orders on your site.
  • You see many payments stuck with the same reason.
  • You rely on a notification method nobody set up or remembers.

How do I handle it?

  1. Sort the stuck ordersI split them into those PayPal still shows as pending and those PayPal completed but your system missed.
  2. Read the integration against PayPal's docsI check which API your site calls and which events it listens to, using PayPal's own reference.
  3. Trace one message end to endI follow one completed payment from PayPal's event record to your handler and its response, in a sandbox first.
  4. Make completion event-drivenI make the order state follow PayPal's pending and completed events, and keep the buyer's return as a courtesy page, not the trigger.
  5. Repair missed orders safelyMissed orders are fixed from PayPal's records one by one, with a log, and no buyer is charged twice.

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 a pending payment take?

It depends on the reason recorded on the payment. I cannot give a time, because PayPal decides when it moves.

Is the payment lost if my site shows pending?

Not necessarily. Check the payment in PayPal first; the money may be completed while your site has not heard.

Should I mark the order paid by hand?

Only once PayPal shows the payment completed, and keep the PayPal transaction reference with the order.

Is IPN or a webhook better?

PayPal's page describes IPN as part of its older NVP and SOAP tools, which it still supports, and advises new integrations to start with its latest tools.

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.