Skip to main content As part of Mangopay’s aim to guarantee the integrity of transactions conducted using its services, and, in accordance with relevant regulations, our teams may prevent some actions due to country-specific restrictions and prohibitions.
Types There are two types of country-specific restrictions.
1. Refusal of funds entering the Mangopay environment Funds entering the Mangopay environment as pay-ins may be refused based on the country detected as the origin of the payment. How the country of origin is determined depends on the payment method but is based on attributes included in the transaction data.
2. Restrictions on the creation of API objects The Mangopay API prevents platforms from creating or modifying certain objects because of country-related data. Three API objects are concerned:
Users For Natural Users and Legal Users , it is not possible to create users using restricted countries as the following parameters:
Natural Users
CountryOfResidenceAddress.Country
Legal Users
HeadquartersAddress.CountryLegalRepresentative.CountryOfResidenceLegalRepresentativeAddress.Country
Updating these parameters to a restricted country on an existing user results in the user being blocked. To be unblocked, the user must submit a proof of identity and/or address. For further details, see the blocked user guide.
Restrictions on North Korea (KP) also apply to the parameters Nationality (Natural User) and LegalRepresentative.Nationality (Legal User), in addition to the residency parameters described above.
Bank accounts Recipient (or Bank Account) creation is not possible based on the bank’s country of registration (as determined by the bank identification details).Payouts Payout creation is not possible based on the bank’s country of registration, as determined by the identification details of the Recipient or Bank Account specified in the BankAccountId.Because a bank account is required to make a payout, these restrictions usually apply together.
Handling restrictions The following endpoints are available to find out about restrictions in place:
You can also set up a webhook notification for the following event type to be notified when a country’s restrictions are modified:
COUNTRY_AUTHORIZATION_UPDATED
Additional checks Mangopay may rely on information retrieved from the user’s verification documents to apply further restrictions.
Users may be blocked whose identity proof document indicates that their birthplace is in the following countries: CU, IR, and KP.
All restrictions by country All restrictions applied Refused Blocked Blocked Blocked
The following countries have all restrictions applied:
CU - Cuba
IR - Iran (Islamic Republic of)
KP - North Korea (the Democratic People’s Republic of)
MM - Myanmar
SY - Syrian Arab Republic (the)
The following country codes are accepted by the API as part of ISO 3166-1 alpha-2 but they are either no longer used or reference uninhabited territories. They also have all restrictions applied.
AN - Netherlands Antilles
BV - Bouvet Island
GS - South Georgia and the South Sandwich Islands
HM - Heard Island and McDonald Islands
WL - Saint Lucia (specific)
YU - Yugoslavia
User creation not blocked Refused ✅ OK Blocked Blocked
The following countries have all restrictions applied except that user creation is not blocked:
AF - Afghanistan
BY - Belarus
CD - Congo (the Democratic Republic of the)
CF - Central African Republic (the)
ER - Eritrea
ET - Ethiopia
IQ - Iraq
GN - Guinea
LB - Lebanon
LR - Liberia
LY - Libya
ML - Mali
RU - Russian Federation (the)
SD - Sudan (the)
SO - Somalia
SS - South Sudan
UA - Ukraine
VE - Venezuela (Bolivarian Republic of)
YE - Yemen
ZW - Zimbabwe
No restrictions The following countries have no restrictions applied:
AD - Andorra
AE - United Arab Emirates (the)
AG - Antigua and Barbuda
AI - Anguilla
AL - Albania
AM - Armenia
AO - Angola
AQ - Antarctica
AR - Argentina
AS - American Samoa
AT - Austria
AU - Australia
AW - Aruba
AX - Åland Islands
AZ - Azerbaijan
BA - Bosnia and Herzegovina
BB - Barbados
BD - Bangladesh
BE - Belgium
BF - Burkina Faso
BG - Bulgaria
BH - Bahrain
BI - Burundi
BJ - Benin
BL - Saint Barthélemy
BM - Bermuda
BN - Brunei Darussalam
BO - Bolivia (Plurinational State of)
BQ - Bonaire, Sint Eustatius and Saba
BR - Brazil
BS - Bahamas (the)
BT - Bhutan
BW - Botswana
BZ - Belize
CA - Canada
CC - Cocos (Keeling) Islands (the)
CG - Congo (the)
CH - Switzerland
CI - Côte d’Ivoire
CK - Cook Islands (the)
CL - Chile
CM - Cameroon
CN - China
CO - Colombia
CR - Costa Rica
CV - Cabo Verde
CW - Curaçao
CX - Christmas Island
CY - Cyprus
CZ - Czechia
DE - Germany
DJ - Djibouti
DK - Denmark
DM - Dominica
DO - Dominican Republic (the)
DZ - Algeria
EC - Ecuador
EE - Estonia
EG - Egypt
EH - Western Sahara
ES - Spain
FI - Finland
FJ - Fiji
FK - Falkland Islands (the) [Malvinas]
FM - Micronesia (Federated States of)
FO - Faroe Islands (the)
FR - France
GA - Gabon
GB - United Kingdom of Great Britain and Northern Ireland (the)
GD - Grenada
GE - Georgia
GF - French Guiana
GG - Guernsey
GH - Ghana
GI - Gibraltar
GL - Greenland
GM - Gambia (the)
GP - Guadeloupe
GQ - Equatorial Guinea
GR - Greece
GT - Guatemala
GU - Guam
GW - Guinea- Bissau
GY - Guyana
HK - Hong Kong
HN - Honduras
HR - Croatia
HT - Haiti
HU - Hungary
ID - Indonesia
IE - Ireland
IL - Israel
IM - Isle of Man
IN - India
IO - British Indian Ocean Territory (the)
IS - Iceland
IT - Italy
JE - Jersey
JM - Jamaica
JO - Jordan
JP - Japan
KE - Kenya
KG - Kyrgyzstan
KH - Cambodia
KI - Kiribati
KM - Comoros (the)
KN - Saint Kitts and Nevis
KR - Korea (the Republic of)
KW - Kuwait
KY - Cayman Islands (the)
KZ - Kazakhstan
LA - Lao People’s Democratic Republic (the)
LC - Saint Lucia
LI - Liechtenstein
LK - Sri Lanka
LS - Lesotho
LT - Lithuania
LU - Luxembourg
LV - Latvia
MA - Morocco
MC - Monaco
MD - Moldova (the Republic of)
ME - Montenegro
MF - Saint Martin (French part)
MG - Madagascar
MH - Marshall Islands (the)
MK - North Macedonia
MN - Mongolia
MO - Macau
MP - Northern Mariana Islands (the)
MQ - Martinique
MR - Mauritania
MS - Montserrat
MT - Malta
MU - Mauritius
MV - Maldives
MW - Malawi
MX - Mexico
MY - Malaysia
MZ - Mozambique
NA - Namibia
NC - New Caledonia
NE - Niger (the)
NF - Norfolk Island
NG - Nigeria
NI - Nicaragua
NL - Netherlands (the)
NO - Norway
NP - Nepal
NR - Nauru
NU - Niue
NZ - New Zealand
OM - Oman
PA - Panama
PE - Peru
PF - French Polynesia
PG - Papua New Guinea
PH - Philippines (the)
PK - Pakistan
PL - Poland
PM - Saint Pierre and Miquelon
PN - Pitcairn
PR - Puerto Rico
PS - Palestine (State of)
PT - Portugal
PW - Palau
PY - Paraguay
QA - Qatar
RE - Réunion
RO - Romania
RS - Serbia
RW - Rwanda
SA - Saudi Arabia
SB - Solomon Islands
SC - Seychelles
SE - Sweden
SG - Singapore
SH - Saint Helena, Ascension and Tristan da Cunha
SI - Slovenia
SJ - Svalbard and Jan Mayen
SK - Slovakia
SL - Sierra Leone
SM - San Marino
SN - Senegal
SR - Suriname
ST - Sao Tome and Principe
SV - El Salvador
SX - Sint Maarten (Dutch part)
SZ - Eswatini
TC - Turks and Caicos Islands (the)
TD - Chad
TF - French Southern Territories (the)
TG - Togo
TH - Thailand
TJ - Tajikistan
TK - Tokelau
TL - Timor- Leste
TM - Turkmenistan
TN - Tunisia
TO - Tonga
TR - Turkey
TT - Trinidad and Tobago
TV - Tuvalu
TW - Taiwan (Province of China)
TZ - Tanzania, the United Republic of
UG - Uganda
UM - United States Minor Outlying Islands (the)
US - United States of America (the)
UY - Uruguay
UZ - Uzbekistan
VA - Holy See (the)
VC - Saint Vincent and the Grenadines
VG - Virgin Islands (British)
VI - Virgin Islands (U.S.)
VN - Vietnam
VU - Vanuatu
WF - Wallis and Futuna
WS - Samoa
XK - Kosovo
YT - Mayotte
ZA - South Africa
ZM - Zambia
