payee_account_restricted
Easy Fix
PayPal · Checkout API
Payee account restrictions prevent completing this payment.
Quick Answer
Error code PAYEE_ACCOUNT_RESTRICTED on your PayPal Checkout API means: Payee account restrictions prevent completing this payment.. This is usually fixable — see the step-by-step guide below.
Affected Models
Applies to all models
Likely Causes
How to Fix It
1
PayPal: Verify the exact permission/scope required by the endpoint and compare with granted scopes.
2
Check workspace/team/project role bindings for the acting user or app integration.
3
Confirm the target resource belongs to the same tenant/account context as the token.
4
Apply least-privilege scope updates and retry with explicit authorization checks.
5
Log permission-denied events with resource identifiers for faster future triage.
Pro Tip
This is a common issue that most users can resolve without specialized tools. Try the first step before moving on to more complex solutions.
Related Error Codes