Currency codes
Last updated: May 15th, 6:15am
The PayPal REST API supports merchants in a number of countries and supports currencies depending on the payment type, PayPal payments or direct credit card payments.For country-specific offerings and limitations, see PayPal Offerings Worldwide and visit 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.
| Currency | Code |
|---|---|
| Australian Dollar | AUD |
| Brazilian Real 1 | BRL |
| Canadian Dollar | CAD |
| Chinese Renmenbi 1 | CNY |
| Czech Koruna | CZK |
| Danish Krone | DKK |
| Euro | EUR |
| Hong Kong Dollar | HKD |
| Hungarian Forint 0 | HUF |
| Israeli New Shekel | ILS |
| Japanese Yen 0 | JPY |
| Malaysian Ringgit 1 | MYR |
| Mexican Peso | MXN |
| New Taiwan Dollar 0 | TWD |
| New Zealand Dollar | NZD |
| Norwegian Krone | NOK |
| Philippine Peso | PHP |
| Polish Złoty | PLN |
| Pound Sterling | GBP |
| Singapore Dollar | SGD |
| Swedish Krona | SEK |
| Swiss Franc | CHF |
| Thai Baht | THB |
| United States Dollar | USD |
0 - 0-decimal currency.
1 - This currency is supported as a payment currency (buyer currency) or settlement currency (holding currency) only for in-country PayPal accounts. If the settlement account is based outside the country, PayPal converts money into the account's primary currency with applicable currency conversion rate, which include a spread or fee.
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.
To configure your preferences:
- Log in to your PayPal business account at PayPal.com.
- Hover over your name and then click Account Settings from the dropdown menu.
- From the left menu, click Payment preferences.
- Click Update for the Block Payments item. Your settings are automatically saved when you update them.