Currency Codes
Last updated: Aug 15th, 6:12am
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.
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.
PayPal account payments
The REST API supports many countries for PayPal account payments if you have a business account. For country-specific offerings and limitations, see PayPal offerings worldwide and visit your country-specific site.
To specify currencies in request URI and body parameters, use three-character ISO-4217 codes.
Important: Effective 1 April, 2021, PayPal will no longer offer domestic payment services in India. As a result of this, PayPal Payments Private Limited users cannot use Indian rupees (INR) to receive payments. This change, however, has no impact on PayPal’s international services. Users in India can continue to send and receive international payments in US dollars (USD).
The PayPal REST Payments API supports these currencies:
| Currency | Code |
|---|---|
| Australian dollar | AUD |
| Brazilian real 2 | BRL |
| Canadian dollar | CAD |
| 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 2 | 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 |
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 India accounts only.