# Currency codes (/api/codes/currency)



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](https://www.paypal.com/webapps/mpp/country-worldwide) and visit your country-specific site.

> **Info:** **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](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) codes.

Currency

Code

Australian dollar

AUD

Brazilian real 2

BRL

Canadian dollar

CAD

Chinese Renmenbi 3

CNY

Czech koruna

CZK

Danish krone

DKK

Euro

EUR

Hong Kong dollar

HKD

Hungarian forint 1

HUF

Israeli new shekel

ILS

Japanese yen 1

JPY

Malaysian ringgit 3

MYR

Mexican peso

MXN

New Taiwan dollar 1

TWD

New Zealand dollar

NZD

Norwegian krone

NOK

Philippine peso

PHP

Polish złoty

PLN

Pound sterling

GBP

Russian ruble

RUB

Singapore dollar

SGD

Swedish krona

SEK

Swiss franc

CHF

Thai baht

THB

United States dollar

USD

> **Info:** **Note:**
>
> 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.

<a name="payment-receiving-preferences" />

### 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 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.
  1. Log in to your PayPal business account at [www.paypal.com](https://www.paypal.com).
  2. Click the settings icon at the top of your PayPal account page and then click **Account Settings**.
  3. From the left menu, click **Payment preferences**.
  4. Click the Update link for the **Block Payments** item. Update your settings and they save automatically.