REST APIs
    Get Started with PayPal REST APIs
    Authentication
    Postman Guide
    API requests
    API responses
    Core Resources
    Overview
    API Integration
    Release Notes
    Orders
      Orders
      post
      Create order
      get
      Show order details
      patch
      Update order
      post
      Confirm the Order
      post
      Authorize payment for order
      post
      Capture payment for order
      post
      Add tracking information for an Order.
      patch
      Update or cancel tracking information for an order
      post
      Receive updated order information via callback URL
      Definitions
      Address Requirements
      Error Messages
    Orders sdkV2
    Payments
    Payments sdkV2
    Payment Method Tokens
    Payment Method Tokens sdkV3
    Add Tracking
    Catalog Products
    Disputes
    Identity
    Invoicing
    Partner Referrals
    Payment Experience
    Payouts
    Referenced Payouts
    Subscriptions
    Transaction Search
    Webhooks Management
    Webhooks
    Overview
    Webhook event names
    Webhooks Events dashboard
    Webhooks simulator
    Integration
    Sandbox
    Overview
    Accounts
    Bulk Accounts
    Card testing
    Codespaces
    PayPal for Visual Studio Code
    Negative Testing
    Go Live
    Production Environment
    PayPal Application Guidelines
    PayPal Security Guidelines
    Rate Limiting Guidelines
    Idempotency
    Troubleshooting
    Not authorized
    Resource not found
    Unprocessable entity
    Validation error
    Reference
    Currency Codes
    Country Codes
    State & Province Codes
    Locale codes
    Deprecated Resources
    Deprecated resources
    Billing Agreements
    Billing Plans
    Invoicing v1
    Orders v1
    Partner Referrals v1
    Payments v1

Country and region address requirements

The Orders v2 REST API supports many countries for PayPal account payments if you have a business account. Depending on the country or region, a city or postal code may be required to validate an address.

For general country-specific offerings and limitations, see PayPal Offerings Worldwide and visit your country-specific site.

The Orders v2 REST API supports these countries:

Country or region Country or region code City Postal code
Afghanistan AF Required Optional
Aland Islands AX Required Optional
Albania AL Required Optional
Algeria DZ Required Optional
American Samoa AS Required Optional
Andorra AD Required Optional
Angola AO Required Optional
Anguilla AI Required Optional
Antarctica AQ Required Optional
Antigua and Barbuda AG Required Optional
Argentina AR Required Required
Armenia AM Required Optional
Aruba AW Required Optional
Australia AU Required Required
Austria AT Required Required
Azerbaijan AZ Required Optional
Bahamas BS Required Optional
Bahrain BH Required Optional
Bangladesh BD Required Optional
Barbados BB Required Optional
Belarus BY Required Optional
Belgium BE Required Optional
Belize BZ Required Optional
Benin BJ Required Optional
Bermuda BM Required Optional
Bhutan BT Required Required
Bolivia BO Required Optional
Bosnia and Herzegovina BA Required Optional
Botswana BW Required Optional
Bouvet Island BV Required Optional
Brazil BR Required Required
British Indian Ocean Territory IO Required Optional
Brunei Darussalam BN Required Optional
Bulgaria BG Required Optional
Burkina Faso BF Required Optional
Burundi BI Required Optional
Cambodia KH Required Optional
Cameroon CM Required Optional
Canada CA Required Required
Cape Verde Escudo CV Required Optional
Cayman Islands KY Required Optional
Central African Republic CF Required Optional
Chad TD Required Optional
Chile CL Required Optional
China C2 Required Required
China CN Required Required
Christmas Island CX Required Optional
Cocos Islands CC Required Required
Colombia CO Required Optional
Comoros KM Required Required
Congo Democratic Republic CD Required Optional
Congo Democratic Republic ZR Required Optional
Congo Republic CG Required Optional
Cook Islands CK Required Optional
Costa Rica CR Required Optional
Cote Divoire CI Required Optional
Croatia HR Required Optional
Cuba CU Required Optional
Cyprus CY Required Optional
Czech Republic CZ Required Optional
Denmark DK Required Required
Djibouti DJ Required Optional
Dominica DM Required Optional
Dominican Republic DO Required Optional
East Timor TP Required Optional
Ecuador EC Required Optional
Egypt EG Required Optional
El Salvador SV Required Optional
Equatorial Guinea GQ Required Optional
Eritrea ER Required Optional
Estonia EE Required Optional
Ethiopia ET Required Optional
Falkland Islands FK Required Required
Faroe Islands FO Required Required
Federated States Of Micronesia FM Required Optional
Fiji FJ Required Optional
Finland FI Required Optional
France FR Required Required
French Guiana GF Required Optional
French Polynesia PF Required Optional
French Southern Territories TF Required Required
Gabon Republic GA Required Optional
Gambia GM Required Required
Georgia Country GE Required Optional
Germany DE Required Required
Ghana GH Required Optional
Gibraltar GI Required Optional
Greece GR Required Optional
Greenland GL Required Required
Grenada GD Required Optional
Guadeloupe GP Required Optional
Guam GU Required Optional
Guatemala GT Required Optional
Guernsey GG Required Optional
Guinea GN Required Optional
Guinea Bissau GW Required Optional
Guyana GY Required Optional
Haiti HT Required Optional
Heard and Mcdonald Islands HM Required Optional
Honduras HN Required Optional
Hong Kong HK Optional Optional
Hungary HU Required Optional
Iceland IS Required Optional
India IN Required Optional
Indonesia ID Required Optional
Iran IR Required Optional
Iraq IQ Required Optional
Ireland IE Required Optional
Isle of Man IM Required Optional
Israel IL Required Optional
Italy IT Required Required
Jamaica JM Required Optional
Japan JP Optional Required
Jersey JE Required Optional
Jordan JO Required Optional
Kazakhstan KZ Required Optional
Kenya KE Required Optional
Kiribati KI Required Required
Kuwait KW Required Optional
Kyrgyzstan KG Required Required
Laos LA Required Optional
Latvia LV Required Optional
Lebanon LB Required Optional
Lesotho LS Required Optional
Liberia LR Required Optional
Libya LY Required Optional
Liechtenstein LI Required Optional
Lithuania LT Required Optional
Luxembourg LU Required Optional
Macau MO Required Optional
Macedonia MK Required Optional
Madagascar MG Required Optional
Malawi MW Required Optional
Malaysia MY Required Optional
Maldives MV Required Optional
Mali ML Required Optional
Malta MT Required Optional
Marshall Islands MH Required Optional
Martinique MQ Required Optional
Mauritania MR Required Required
Mauritius MU Required Optional
Mayotte YT Required Required
Mexico MX Required Required
Moldova MD Required Optional
Monaco MC Required Optional
Mongolia MN Required Optional
Montenegro ME Required Optional
Montserrat MS Required Optional
Morocco MA Required Optional
Mozambique MZ Required Optional
Myanmar MM Required Optional
Namibia NA Required Optional
Nauru NR Required Required
Nepal NP Required Optional
Netherlands NL Required Required
Netherlands Antilles AN Required Optional
New Caledonia NC Required Optional
New Zealand NZ Required Optional
Nicaragua NI Required Optional
Niger NE Required Required
Nigeria NG Required Optional
Niue NU Required Required
Norfolk Island NF Required Required
North Korea KP Required Optional
Northern Mariana Islands MP Required Optional
Norway NO Required Required
Oman OM Required Optional
Pakistan PK Required Optional
Palau PW Required Optional
Palestinian Territory Occupied PS Required Optional
Panama PA Required Optional
Papua New Guinea PG Required Optional
Paraguay PY Required Optional
Peru PE Required Optional
Philippines PH Required Optional
Pitcairn Islands PN Required Required
Poland PL Required Required
Portugal PT Required Optional
Puerto Rico PR Required Optional
Qatar QA Required Optional
Reunion RE Required Optional
Romania RO Required Optional
Russia RU Required Optional
Rwanda RW Required Optional
Samoa WS Required Optional
San Marino SM Required Required
Sao Tome and Principe ST Required Optional
Saudi Arabia SA Required Optional
Senegal SN Required Optional
Serbia RS Required Optional
Serbia and Montenegro CS Required Optional
Seychelles SC Required Optional
Sierra Leone SL Required Optional
Singapore SG Optional Required
Slovakia SK Required Optional
Slovenia SI Required Optional
Solomon Islands SB Required Optional
Somalia SO Required Optional
South Africa ZA Required Optional
South Georgia and the South Sandwich Islands GS Required Optional
South Korea KR Required Optional
Spain ES Required Required
Sri Lanka LK Required Optional
St Helena SH Required Required
St Kitts and Nevis KN Required Optional
St Lucia LC Required Optional
St Pierre and Miquelon PM Required Required
St Vincent and the Grenadines VC Required Optional
Sudan SD Required Optional
Suriname SR Required Required
Svalbard and Jan Mayen Islands SJ Required Required
Swaziland SZ Required Optional
Sweden SE Required Required
Switzerland CH Required Required
Syria SY Required Optional
Taiwan TW Required Optional
Tajikistan TJ Required Optional
Tanzania TZ Required Optional
Thailand TH Required Required
Timor Leste TL Required Optional
Togo TG Required Optional
Tokelau TK Required Required
Tonga TO Required Optional
Trinidad and Tobago TT Required Optional
Tunisia TN Required Optional
Turkey TR Required Optional
Turkmenistan TM Required Optional
Turks and Caicos Islands TC Required Optional
Tuvalu TV Required Required
Uganda UG Required Optional
Ukraine UA Required Optional
United Arab Emirates AE Required Optional
United Kingdom GB Required Required
United States US Required Required
Uruguay UY Required Optional
US Minor Outlying Islands UM Required Required
Uzbekistan UZ Required Optional
Vanuatu VU Required Optional
Vatican City State VA Required Required
Venezuela VE Required Optional
Viet Nam VN Required Optional
Virgin Islands British VG Required Optional
Virgin Islands USA VI Required Optional
Wallis and Futuna Islands WF Required Required
Western Sahara EH Required Required
Yemen YE Required Optional
Yugoslavia YU Required Optional
Zambia ZM Required Optional
Zimbabwe ZW Required Optional
Reference
PayPal.com
Privacy
Support
Legal
Contact