Skip to main content
PayPal’s REST APIs support merchants across multiple countries and various currencies, depending on the payment method: PayPal payments or direct credit card payments. For country-specific offerings and limitations, see the PayPal Offerings Worldwide page or your country-specific site.
Note: To receive payments in a currency that you do not hold in your PayPal account, you must configure your Payment Receiving Preferences within your account. Otherwise, the payment status remains pending until you manually approve the payment in your PayPal account.
To specify currencies in request URI and body parameters, use three-character ISO-4217 codes.
CurrencyCode
Australian dollarAUD
Brazilian real 2BRL
Canadian dollarCAD
Chinese Renmenbi 3CNY
Czech korunaCZK
Danish kroneDKK
EuroEUR
Hong Kong dollarHKD
Hungarian forint 1HUF
Israeli new shekelILS
Japanese yen 1JPY
Malaysian ringgit 3MYR
Mexican pesoMXN
New Taiwan dollar 1TWD
New Zealand dollarNZD
Norwegian kroneNOK
Philippine pesoPHP
Polish złotyPLN
Pound sterlingGBP
Russian rubleRUB
Singapore dollarSGD
Swedish kronaSEK
Swiss francCHF
Thai bahtTHB
United States dollarUSD
1 This currency does not support decimals. If you pass a decimal amount, an error occurs.
2 This currency is supported as a payment currency and a currency balance for in-country PayPal accounts only. If the receiver of funds is not from Brazil, then PayPal converts funds into the primary holding currency of the account with the applicable currency conversion rate. The currency conversion rate includes PayPal’s applicable spread or fee.
3 This currency is supported as a payment currency and a currency balance for in-country PayPal accounts only.

​
Payment Receiving Preferences

If you have a PayPal Premier or Business account, configure your Payment Receiving Preferences to handle payments automatically. You can convert any payment into your primary currency or block certain types of payments. You can set the following:
  • Block or unblock payments from U.S. customers who don’t have a confirmed address.
  • Block or unblock payments sent to you in a currency you don’t hold.
  • Block or unblock payments for duplicate invoice IDs.
  • Block or unblock payments from customers who have non-U.S. PayPal accounts.
  • Block or unblock payments from Student Account holders.
  • Log in to your PayPal business account at www.paypal.com .
  • Click the settings icon at the top of your PayPal account page and then click Account Settings .
  • From the left menu, click Payment preferences .
  • Click the Update link for the Block Payments item. Update your settings and they save automatically.
⌘I