HomeBrandsPayPalCheckout APIcurrency_not_supported
P
currency_not_supported
Easy Fix
PayPal · Checkout API
Currency is unsupported for this account/operation.
Quick Answer
Error code CURRENCY_NOT_SUPPORTED on your PayPal Checkout API means: Currency is unsupported for this account/operation.. This is usually fixable — see the step-by-step guide below.
Affected Models
Applies to all models
PAYPAL-LIVEPAYPAL-ORDERSPAYPAL-PAYOUTSPAYPAL-SANDBOXPAYPAL-SUBSPAYPAL-WEBHOOKS
Likely Causes
  1. Payload schema, field type, or request shape does not satisfy endpoint contract.
  2. One or more required fields are missing, malformed, or semantically inconsistent.
  3. Client serialization transformed values in a way the API rejects at validation time.
How to Fix It
1
PayPal: Validate request payload against the latest API schema before sending.
2
Inspect field-level errors and correct type, format, and required-field completeness.
3
Replay the same call with a minimal valid payload to isolate offending attributes.
4
Enforce strict client-side validation and schema version pinning in your integration.
5
Add contract tests so this validation pattern is caught before deployment.
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
INSTRUMENT_DECLINEDPAYER_ACTION_REQUIREDTRANSACTION_REFUSEDDUPLICATE_TRANSACTIONVALIDATION_ERROR
Video Guides
Loading video guides…
Search more on YouTube →