Currency Codes

DOCS

Last updated: Aug 5th, 4:47pm

To specify currencies in fields and variables for the Express Checkout, PayPal Payments Standard, and Website Payments Pro APIs, use three-character ISO-4217 codes.

PayPal accepts credit and debit cards issued globally.

PayPal provides the Multi-currency functionality, which allows merchants to accept payments in a variety of currencies for the buyer's and merchant's convenience. This feature helps merchants reach additional customers who prefer to pay in their local currency. It also helps eliminate the need for merchants to maintain multiple accounts in more than one currency because the merchant's PayPal account can hold balances in multiple currencies. In the event that Multi-currency is unavailable, the transaction is settled in the merchant's local currency.

Acceptance of certain currencies may be subject to regulatory requirements or restrictions. Currency options may also be limited for high risk categories. Contact your PayPal account representative for more information.



Multi-currency Support List

Multi-currency support for PayPal payments

The following table details multi-currency support for PayPal payment transactions that use Express Checkout, PayPal payment buttons (PayPal Payment Standard) and other PayPal products.

Currency Currency code Notes
Australian Dollar AUD
Brazilian Real BRL 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.
Canadian Dollar CAD
Chinese Renminbi CNY This currency is supported as a payment currency and a currency balance for in-country PayPal accounts only.
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 Sheqel ILS
Japanese Yen JPY Zero-digit currency; no decimal places or fractions

Per-transaction limit: 1,000,000
Malaysian Ringgit MYR This currency is supported as a payment currency and a currency balance for in-country PayPal accounts only.
Mexican Peso MXN
Norwegian Krone NOK
New Zealand Dollar NZD
Philippine Peso PHP
Polish Zloty PLN
Pound Sterling GBP
Russian Ruble RUB For in-border payments (payments made within Russia), the Russian Ruble is the only accepted currency. If you use another currency for in-border payments, the transaction fails and returns the 10001 error code – Internal Error.
Singapore Dollar SGD
Swedish Krona SEK
Swiss Franc CHF
Taiwan New Dollar TWD Zero-digit currency; no decimal places or fractions
Thai Baht THB
U.S. Dollar USD


Multi-currency support for direct credit card products

Supported major credit cards and currencies

The following table details the major credit cards supported and multi-currency support in direct credit card transactions (transactions that are not branded as PayPal transactions), sorted by the merchant's country.

The products listed in this table support payments with buyer credit cards issued in any country.

Country Name Product Name(s) Major credit cards Multi-currency Support
Australia Website Payments Pro Hosted Solution American Express (AUD only), Mastercard, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
Canada PayPal Payments Pro
PayPal Payments Advanced1
Website Payments Pro2
American Express (CAD only), JCB (CAD only), Mastercard, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
France PayPal Intégral Evolution 4 étoiles, Carte Aurore, Carte Bancaire, Cofinoga, Mastercard, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
Hong Kong Website Payments Pro Hosted Solution Mastercard, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
Italy PayPal Pro Carta Aura, Mastercard, PayPal Prepaid, Postepay, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
Japan Website Payments Plus JCB (JPN only), Mastercard, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0,3, NOK, NZD0, PLN, SEK, SGD, USD
Singapore Website Payments Pro Hosted Solution Mastercard, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
Spain Pasarela Integral Mastercard, Tarjeta Aurora, Visa AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
UK Website Payments Pro Hosted Solution Discover, Maestro, Mastercard, Visa, Visa Debit, Visa Electron AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF0, JPY0, NOK, NZD0, PLN, SEK, SGD, USD
USA PayPal Payments Pro
PayPal Payments Advanced1
Website Payments Pro2
American Express (USD only), Discover (USD only), Mastercard, Visa AUD, CAD, EUR, GBP, JPY0,3, USD

0 Zero-digit currency; no decimal places or fractions.

1 No longer actively marketed; now included with PayPal Payments Pro.

2 No longer actively marketed; predecessor to PayPal Payments Pro.

3 JPY transactions have a per transaction amount limit of approximately 1,000,000 JPY.


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:

  1. Log in to your PayPal business account at PayPal.com.
  2. Hover over your name and then click Account Settings from the dropdown menu.
  3. From the left menu, click Payment preferences.
  4. Click Update for the Block Payments item. Your settings are automatically saved when you update them.