# Currency codes (/reference/currency-codes)

Use these currency codes when you specify currency in API requests and interpret currency fields in reports.



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. Specifying the correct currency code in your API requests ensures transactions are processed and settled in the intended currency. For country-specific offerings and limitations, see [PayPal Offerings Worldwide](https://www.paypal.com/us/webapps/mpp/country-worldwide) and visit your country-specific site.

To specify currencies in request URI and body parameters, use [three-character ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) codes.

> **Note:** To receive payments in a currency that you do not hold in your PayPal account, you must [configure your Payment Receiving Preferences](#payment-receiving-preferences) within your account. Otherwise, the payment status remains pending until you manually approve the payment in your PayPal account.

| Currency             | Code  | Notes                                                |
| -------------------- | ----- | ---------------------------------------------------- |
| Australian Dollar    | `AUD` |                                                      |
| Brazilian Real ¹     | `BRL` |                                                      |
| Canadian Dollar      | `CAD` |                                                      |
| Chinese Renminbi ¹   | `CNY` |                                                      |
| Czech Koruna         | `CZK` |                                                      |
| Danish Krone         | `DKK` |                                                      |
| Euro                 | `EUR` |                                                      |
| Hong Kong Dollar     | `HKD` |                                                      |
| Hungarian Forint     | `HUF` | Zero-digit currency — no decimal places or fractions |
| Israeli New Shekel   | `ILS` |                                                      |
| Japanese Yen         | `JPY` | Zero-digit currency — no decimal places or fractions |
| Malaysian Ringgit ¹  | `MYR` |                                                      |
| Mexican Peso         | `MXN` |                                                      |
| New Taiwan Dollar    | `TWD` | Zero-digit currency — no decimal places or fractions |
| 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` |                                                      |

¹ 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 the applicable currency conversion rate, which includes a spread or fee.

## Payment Receiving Preferences [#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 set these preferences in your PayPal account under **Account Settings > Payment preferences**.

## Related resources [#related-resources]

* For a list of countries that PayPal supports, see     [Country codes](/reference/country-codes/).
* For country-specific offerings and limitations, see [PayPal Offerings Worldwide](https://www.paypal.com/us/webapps/mpp/country-worldwide).
