Common Issues
- Payment Holds - PayPal may hold funds for new merchants (up to 21 days for first transactions).
- Account Limitations - Complete business verification to avoid payment restrictions.
- Webhook Reliability - PayPal may retry webhooks; make handlers idempotent and implement duplicate detection.
- Currency Conversion - Be aware of conversion fees and rates; consider multi-currency accounts.
- Authentication Tokens - Access tokens expire; implement refresh logic for long-running processes.
- Rate Limiting - PayPal limits API calls; implement exponential backoff for retries.
Payment holds are how PayPal manages risk on new or unusual activity. New merchants often see 21-day holds on their first transactions, and in high-risk categories a hold can run to 180 days. The payment succeeded, the customer was charged, and you still can't touch the money. For a bootstrapped business that's a serious cash flow problem. Build 30-60 days of operating reserves before you launch on PayPal, or run it alongside a provider that pays out immediately.
PayPal's sandbox environment is where you test, but don't mistake it for production. Test accounts have unlimited funds, which is the least realistic thing about them; some features behave differently; and webhook timing won't match live. Before you launch, run a few small real transactions in production. Sandbox catches integration bugs. It can't tell you whether PayPal is about to hold your funds or limit your account.
Why you carry the risk anyway, from the same chapter.
Advantages:
- Massive global user base and brand recognition.
- Customers don't need to enter card details.
- Strong buyer protection builds trust.
- Supports 200+ markets and 100+ currencies.
- Multiple integration options (hosted, API, SDK).
- Guest checkout available (no PayPal account required).
Considerations:
- Higher fees than some competitors (2.9% + fixed fee).
- More complex dispute resolution process.
- Account limitations can freeze funds.
- Inconsistent user experience across regions.
- More limited customization compared to Stripe.
PayPal can limit your account and freeze your funds without warning, especially if you're a new merchant or your transaction pattern looks unusual. Common triggers: rapid volume increases, high-value transactions when new, selling in restricted categories, or elevated dispute rates. Frozen funds can sit under review for 21-180 days. Keep reserves and a second provider so a hold doesn't turn into a cash flow crisis.
Best for:
- E-commerce with international customers.
- Businesses where buyer trust is critical.
- One-time payments and simple subscriptions.
- Marketplaces (via PayPal for Marketplaces).
PayPal's 439 million active accounts (Q2 2026) bring instant trust, especially to international sales. Offer PayPal next to cards and checkout conversion rises 10-15%. Three reasons: nobody has to type card details, buyer protection reassures customers who don't know you, and guest checkout takes card payments through PayPal without an account. For international e-commerce, PayPal is often non-negotiable.