Element Code Tables

The following codes are used to populate certain elements. Only these codes are allowed.

Language

LanguageCode
Danish (dansk)da
Dutch (nederlands)nl
Englishen
Finnish (suomalainen)fi
French (francais)fr
German (deutsch)de
Italian (italiano)it
Norwegian (norsk)no
Polish (polski)pl
Spanish (espanol)es
Swedish (svenska)sv

States, Territories, and Provinces

States in the U.S.Code
AlabamaUSA_AL
AlaskaUSA_AK
ArizonaUSA_AZ
ArkansasUSA_AR
CaliforniaUSA_CA
ColoradoUSA_CO
ConnecticutUSA_CT
DelawareUSA_DE
Washington, D.C.USA_DC
FloridaUSA_FL
GeorgiaUSA_GA
HawaiiUSA_HI
IdahoUSA_ID
IllinoisUSA_IL
IndianaUSA_IN
IowaUSA_IA
KansasUSA_KS
KentuckyUSA_KY
LouisianaUSA_LA
MaineUSA_ME
MarylandUSA_MD
MassachusettsUSA_MA
MichiganUSA_MI
MinnesotaUSA_MN
MississippiUSA_MS
MissouriUSA_MO
MontanaUSA_MT
NebraskaUSA_NE
NevadaUSA_NV
New HampshireUSA_NH
New JerseyUSA_NJ
New MexicoUSA_NM
New YorkUSA_NY
North CarolinaUSA_NC
North DakotaUSA_ND
OhioUSA_OH
OklahomaUSA_OK
OregonUSA_OR
PennsylvaniaUSA_PA
Rhode IslandUSA_RI
South CarolinaUSA_SC
South DakotaUSA_SD
TennesseeUSA_TN
TexasUSA_TX
UtahUSA_UT
VermontUSA_VT
VirginiaUSA_VA
WashingtonUSA_WA
West VirginiaUSA_WV
WisconsinUSA_WI
WyomingUSA_WY
Canada’s Territories and ProvincesCode
AlbertaCAN_AB
British ColumbiaCAN_BC
ManitobaCAN_MB
New BrunswickCAN_NB
Newfoundland and LabradorCAN_NL
Nova ScotiaCAN_NS
Northwest TerritoriesCAN_NT
NunavutCAN_NU
OntarioCAN_ON
Prince Edward IslandCAN_PE
QuebecCAN_QC
SaskatchewanCAN_SK
YukonCAN_YT
Mexico’s StatesCode
AguascalientesMEX_AG
Baja CaliforniaMEX_BC
Baja California SurMEX_BS
CampecheMEX_CM
ChiapasMEX_CS
ChichuahuaMEX_CH
CoahuilaMEX_CO
ColimaMEX_CL
Mexico CityMEX_DF
DurangoMEX_DG
GuanajuatoMEX_GT
GuerreroMEX_GR
HidalgoMEX_HG
JaliscoMEX_JA
MéxicoMEX_ME
MichoacánMEX_MI
MorelosMEX_MO
NayaritMEX_NA
Nuevo LeónMEX_NL
OaxacaMEX_OA
PueblaMEX_PB
QuerétaroMEX_QE
Quintana RooMEX_QR
San Luis PotosíMEX_SL
SinaloaMEX_SI
SonoraMEX_SO
TabascoMEX_TB
TamaulipasMEX_TM
TlaxcalaMEX_TL
VeracruzMEX_VE
YucatánMEX_YU
ZacatecasMEX_ZA
Italy’s ProvincesCode
AgrigentoITA_AG
AlessandriaITA_AL
AnconaITA_AN
AostaITA_AO
ArezzoITA_AR
Ascoli PicenoITA_AP
AstiITA_AT
AvellinoITA_AV
BariITA_BA
BellunoITA_BL
BeneventoITA_BN
BergamoITA_BG
BiellaITA_BI
BolognaITA_BO
BolzanoITA_BZ
BresciaITA_BS
BrindisiITA_BR
CagliariITA_CA
CaltanissettaITA_CL
CampobassoITA_CB
CasertaITA_CE
CataniaITA_CT
CatanzaroITA_CZ
ChietiITA_CH
ComoITA_CO
CosenzaITA_CS
CremonaITA_CR
CrotoneITA_KR
CuneoITA_CN
EnnaITA_EN
FerraraITA_FE
FirenzeITA_FI
FoggiaITA_FG
Forlě-CesenaITA_FC
FoggiaITA_FO
FrosinoneITA_FR
GenovaITA_GE
GrossetoITA_GR
ImperiaITA_IM
IserniaITA_IS
La SpeziaITA_SP
L’AquilaITA_AQ
LatinaITA_LT
LecceITA_LE
LeccoITA_LC
LivornoITA_LI
LodiITA_LO
LuccaITA_LU
MacerataITA_MC
MantovaITA_MN
Massa-CarraraITA_MS
MateraITA_MT
MessinaITA_ME
MilanoITA_MI
ModenaITA_MO
NapoliITA_NA
NovaraITA_NO
NuoroITA_NU
OristanoITA_OR
PadovaITA_PD
PalermoITA_PA
ParmaITA_PR
PaviaITA_PV
PerugiaITA_PG
Pesaro e UrbinoITA_PU
PescaraITA_PE
PiacenzaITA_PC
PisaITA_PI
PistoiaITA_PT
PotenzaITA_PZ
PratoITA_PO
RagusaITA_RG
RavennaITA_RA
Reggio CalabriaITA_RC
Reggio EmiliaITA_RE
RietiITA_RI
RiminiITA_RN
RomaITA_RM
RovigoITA_RO
SalernoITA_SA
SassariITA_SS
SavonaITA_SV
SienaITA_SI
SiracusaITA_SR
SondrioITA_SO
TarantoITA_TA
TeramoITA_TE
TerniITA_TR
TorinoITA_TO
TrapaniITA_TP
TrentoITA_TN
TrevisoITA_TV
VareseITA_VA
VeneziaITA_VE
Verbano-Cusio-OssolaITA_VB
VercelliITA_VC
VeronaITA_VR
Vibo ValentiaITA_VV
VicenzaITA_VI
ViterboITA_VT

Principal

The Principal object contains several fields. Each field accepts a specific list of enumerated values.

titleType

  • ACCOUNTING_MANAGER
  • AUTHORIZED_SIGNER
  • CONTROLLER
  • CHIEF_EXECUTIVE_OFFICER
  • CHIEF_FINANCIAL_OFFICER
  • CHIEF_OPERATING_OFFICER
  • CHAIRMAN
  • COSIGNER
  • DIRECTOR
  • GENERAL_MANAGER
  • GENERAL_PARTNER
  • GUARANTOR
  • MANAGING_MEMBER
  • OFFICER
  • PROPRIETOR_OR_OWNER
  • PRESIDENT
  • PARTNER_OR_PRINCIPAL
  • SECRETARY
  • TREASURER
  • TRUSTEE
  • VICE_PRESIDENT
  • OTHER

positions

  • BENEFICIAL_OWNER
  • SOLE_PROP
  • AUTHORIZED_SIGNER

idType

  • SIN
  • ITIN
  • ID_CARD
  • GOVERNMENT_ISSUED_ID
  • FOREIGN_PASSPORT
  • RESIDENT_ALIEN_CARD

documentaryVerifier

  • SALES_TEAM
  • NOT_VERIFIED

documentaryType

  • DRIVER_LICENSE
  • FOREIGN_VISA
  • FOREIGEN_PHOTO_ID
  • US_ALIEN_ID
  • US_MILITARY_ID
  • STATE_ID
  • PASSPORT

alternateAddressDocumentType

  • BANK_STATEMENT
  • UTILITY_BILL
  • OTHER

classification

  • BUSINESS_STREET_ADDRESS
  • PHYSICAL_RESIDENTIAL_ADDRESS

Business Info

Ownership Type (businessInfo.ownershipType)

Property NameValue(s)Definition
Sole ProprietorshipSOLE_TRADEROne person owns all assets, owes all liabilities, and conducts affairs in one’s own capacity, often under an assumed name (Doing Business As, or DBA).
Limited Liability Company (LLC) filing as a CorporationownershipType: LIMITED_COMPANY

taxClassType: CORPORATION		A company - statutorily authorized in many states - that is characterized by limited liability, is managed by members or managers, and has limitations on ownership transfer. A Limited Liability Company (LLC) may elect to file as a corporation for tax purposes.

Note that two fields, ownershipType and taxClassType, must be set for this business type.
LLC filing as a PartnershipownershipType: LIMITED_COMPANY

taxClassType: PARTNERSHIP		A company - statutorily authorized in many states - that is characterized by limited liability, is managed by members or managers, and has limitations on ownership transfer. By default, an LLC with more than one owner files as a Partnership.

Note that two fields, ownershipType and taxClassType, must be set for this business type.
Single-Member LLC filing as a Disregarded EntityownershipType: LIMITED_COMPANY

taxClassType: DISREGARDED_ENTITY		A company - statutorily authorized in many states - that is characterized by limited liability, is managed by members or managers, and has limitations on ownership transfer. By default, an LLC with one owner pays taxes on the owner’s personal tax return and the LLC is considered a “disregarded entity.”

Note that two fields, ownershipType and taxClassType, must be set for this business type.
Private C CorporationC_CORPORATION_PRIVATE_COMPANYA private corporation whose income is taxed at the corporate level rather than at the shareholder level.
S CorporationSUB_S_CORPORATIONA corporation whose income is taxed at the shareholder level, similar to a Partnership’s income, rather than at the corporate level.
General PartnershipEU only: PARTNERSHIP
NA only: GENERAL_PARTNERSHIP		A partnership in which all partners participate fully in running the business and share equally in profits and losses, though the partners’ monetary contributions may vary.
Limited Liability Partnership (LLP)LIMITED_LIBABILITY_PARTNERSHIP
(Don’t correct the spelling; it is how this value is coded.)		EU-only option. An LLP must have a managing partner that is liable for the actions of the partnership. As long as silent partners and investors don’t assume a managerial role, they receive liability protection.
Limited Partnership (LP)LIMITED_LIBABILITY_PARTNERSHIP
(Don’t correct the spelling; it is how this value is coded.)		A partnership composed of one or more persons who control the business and are personally liable for the Partnership’s debts (called General Partners). One or more persons who contribute capital and share profits but who cannot manage the business and are liable only for the amount of their contribution (called Limited Partners).

For North America (NA), to use this ownershipType, PAPI needs to be sent LIMITED_LIBABILITY_PARTNERSHIP.
Tax-Exempt Public CharityCHARITYA corporation organized under 501(c)(3) for some purpose other than making a profit (such as charitable or educational purposes).
A public charity is traditionally funded by tax-deductible donations.
Tax-Exempt Private FoundationFOUNDATIONEU-only option. A corporation organized under 501(c)(3) for some purpose other than making a profit (such as charitable or educational purposes).
A private foundation is traditionally established with funds from a single source or specific sources.
Unincorporated AssociationCLUBSmall groups of people who band together because of a shared interest or activity.
Public Limited CompanyPUBLIC_LIMITED_COMPANYA company that has limited liability and offers shares to the general public thereby owning a limited amount of its own shares.
TrustTRUSTAn entity created to hold assets for the benefit of certain persons or entities.
Public C CorporationC_CORPORATION_PUBLIC_COMPANYA public corporation whose income is taxed at the corporate level rather than at the shareholder level.
GovernmentGOVERNMENTThe governing body of a nation, state, or community, which is excluded from being taxed on any income derived from the exercise of or administration of any public function.
EstateESTATEA guardian who manages all the possessions and oversees administration of their ward’s assets.
OtherOTHEREU-only classification. Business type doesn’t fit into any of the business types that have already been listed.

businessInfo Additional Properties

This is used to specify which types of documentation are considered valid and accepted, which vary by country.

documentType(All)

  • GOVERNMENT_BUSINESS_LICENSE

documentType(USA)

  • CERTIFIED_INCORPORATION_ARTICLES
  • SIGNED_OPERATING_AGREEMENT
  • SIGNED_TESTAMENTARY_LETTER
  • SIGNED_EXECUTORSHIP_LETTER
  • SIGNED_ASSOCIATION_ARTICLES
  • SIGNED_PARTNERSHIP_AGREEMENT
  • SIGNED_LIMITED_PARTNERSHIP_AGREEMENT
  • SIGNED_LIMITED_LIABILITY_AGREEMENT
  • DEED_OF_TRUST

documentType(CAN)

  • FEDERAL_CERTIFICATE_OF_AMALGAMATION
  • CERTIFICATE_OF_STATUS
  • GOVERNMENT
  • BUSINESS_NAME_REPORT
  • CORPORATE_PROFILE_REPORT_BY_GOVERNMENT_SITES
  • BYLAWS
  • ANNUAL_SECURITIES_FILING
  • PARTNERSHIP_AGREEMENTS
  • INCORPORATION_DOCUMENTS_FILED_WITH_GOVERNMENT
  • LETTERS_PATENT
  • NAME_CHANGE_DOCUMENTS_FILED_WITH_GOVERNMENT
  • ARTICLES_OF_INCORPORATION
  • LETTER_OF_NOTICE_OF_ASSESSMENT_FROM_GOVERNMENT
  • BUSINESS_REGISTRATION
  • SIGNED_INDEPENDENT_CORPORATE_ANNUAL_AUDIT
  • CERTIFICATE_OF_INCORPORATION
  • NOTICE_OF_CHANGE

taxClassType

  • CORPORATION
  • DISREGARDED_ENTITY
  • PARTNERSHIP

taxIDType

  • FEDERAL_TAX_ID
  • SOCIAL_INSURANCE_NUMBER
  • BUSINESS_REGISTRATION_NUMBER
  • TAX_ID_NUMBER
  • SOCIAL_SECURITY_NUMBER

taxFormType

  • W9
  • W8BEN
  • W8IMY

exemptionType

exemptionType(All)

  • ADDITIONAL_LOCATION
  • FINANCIAL_INSTITUTION
  • NON_PROFIT
  • PUBLICLY_TRADED
  • SUBSIDIARY_OF_PUBLICLY_TRADED

exemptionType(USA)

  • STATE_REGULATED_BANK
  • US_STATE_DEPARTMENT
  • US_FEDERAL_GOVERNMENT
  • US_LOCAL_GOVERNMENT

exemptionType(CAN)

  • CAN_PROVINCIAL_FEDERAL
  • INCORPORATED_MUNICIPAL_BODY
  • INCORPORATED_REGIONAL_ENTITY
  • PUBLIC_HOSPITAL_AUTHORITY

ownerExemptionType

  • BANK_ADVISED_POOLED
  • BANK_ADVISED_POOLED_RP
  • BANK_HOLDING_COMPANY_ACT
  • CFR
  • COMMODITY_EXCHANGE_ACT
  • FINANCIAL_MARKET_UTILITY
  • FOREIGN_BANK
  • FOREIGN_GOVERNMENT
  • INVESTMENT_COMPANY_ACT_ADVISOR
  • INVESTMENT_COMPANY_ACT_COMPANY
  • NON_PROFIT
  • PUBLIC_ACCOUNTING_FIRM
  • SECURITIES_EXCHANGE_ACT_CLEARING
  • SECURITIES_EXCHANGE_ACT_ISSUER
  • SECURITIES_EXCHANGE_ACT_REGISTERED
  • STATE_REGULATED_INSURANCE
  • SUBSIDIARY_OF_PUBLIC_TRADE
  • NONE

siteSurvey

locationType

  • HOME
  • INDUSTRIAL_ESTATE
  • KIOSK
  • OFFICE_BUILDING
  • RETAIL
  • SEPARATE_BUILDING
  • SHOPPING_CENTRE
  • OTHER

Card Charge

cardType

  • VISA
  • VISA_DEBIT
  • VISA_ELECTRON
  • DISCOVER
  • MASTERCARD
  • MASTERCARD_DEBIT
  • AMERICAN_EXPRESS
  • UNIONPAY_DEBIT

pricingCategory

  • RETAIL
  • RESTAURANT
  • INTERNET
  • SUPERMARKET
  • LODGING
  • MOTO
  • OMNICOMMERCE Note: Available only for Tiered Pricing Method.

pricingMethod

  • ASSOCIATION
  • CLEAR_AND_SIMPLE
  • SURCHARGE_PRICING
  • INTERCHANGE_PLUS
  • ENHANCED_INTERCHANGE_PLUS
  • INTERCHANGE_DIFFERENTIAL
  • FIXED
  • TIERED_PRICING
  • FIXED_C4_PRICING
  • FIXED_C4_PRICING_MERCHANT_MANAGED
  • FIXED_C4_PRICING_ELAVON_MANAGED

Dynamic Currency Conversion

rebatePercent

DCC rebate should be based on the mark-up rate selected.

Default DCC Values

Default DCC Mark-Up RateRebate %
3.25% mark-up1.25% rebate
3.75% mark-up1.50% rebate
4.25% mark-up1.75% rebate

dccMarkUp

  • Zero
  • One_point_nine_zero
  • Two_point_five_zero
  • Two_point_nine_five
  • Three_point_zero_zero
  • Three_point_two_five
  • Three_point_five_zero
  • Three_point_seven_five
  • Four_point_zero_zero

currencyGroup

  • All_usd_dcc_currencies
  • All_cad_dcc_currencies

International Phone Codes

CountryDial Code
Afghanistan93
Albania355
Algeria213
Andorra376
Angola244
Argentina54
Armenia374
Aruba297
Australia61
Australian External Territories672
Austria43
Azerbaijan994
Bahrain973
Bangladesh880
Belarus375
Belgium32
Belize501
Benin229
Bhutan975
Bolivia591
Bosnia and Herzegovina387
Botswana267
Brazil55
British Indian Ocean Territory246
Brunei673
Bulgaria359
Burkina Faso226
Burundi257
Cambodia855
Cameroon237
Cape Verde238
Central African Republic236
Chad235
Chile56
China86
Colombia57
Comoros269
Cook Islands682
Costa Rica506
Croatia385
Cuba53
Cyprus357
Czech Republic420
Denmark45
Djibouti253
East Timor670
Ecuador593
Egypt20
El Salvador503
Eritrea291
Estonia372
Eswatini268
Ethiopia251
Falkland Islands500
Faroe Islands298
Federated States of Micronesia691
Fiji679
Finland358
Former Netherlands Antilles599
France33
French Guiana594
French Polynesia689
Gabon241
Gambia220
Georgia995
Germany49
Ghana233
Gibraltar350
Greece30
Guadeloupe (including Saint Barthélemy, Saint Martin)590
Guatemala502
Guernsey, Jersey, and Isle of Man441
Guinea224
Guinea-Bissau245
Guyana592
Haiti509
Honduras504
Hong Kong852
Hungary36
Iceland354
India91
Indonesia62
Iran98
Iraq964
Ireland353
Israel972
Italy39
Ivory Coast225
Japan81
Jordan962
Kenya254
Kiribati686
Kuwait965
Kyrgyzstan996
Laos856
Latvia371
Lebanon961
Lesotho266
Liberia231
Libya218
Liechtenstein423
Lithuania370
Luxembourg352
Macau853
Madagascar261
Malawi265
Malaysia60
Maldives960
Mali223
Malta356
Marshall Islands692
Martinique596
Mauritania222
Mauritius230
Mexico52
Moldova373
Monaco377
Mongolia976
Morocco212
Mozambique258
Myanmar95
Namibia264
Nauru674
Nepal977
Netherlands31
New Caledonia687
New Zealand64
Nicaragua505
Niger227
Nigeria234
Niue683
North Macedonia389
Norway47
Oman968
Pakistan92
Palau680
Palestine970
Panama507
Papua New Guinea675
Paraguay595
Peru51
Philippines63
Poland48
Portugal351
Qatar974
Republic of the Congo242
Réunion262
Romania40
Russia7
Rwanda250
Saint Helena290
Saint-Pierre and Miquelon508
Samoa685
San Marino378
Săo Tomé and Príncipe239
Saudi Arabia966
Senegal221
Serbia381
Seychelles248
Sierra Leone232
Singapore65
Slovakia421
Slovenia386
Solomon Islands677
Somalia252
South Africa27
South Korea82
Spain34
Sri Lanka94
Sudan249
Suriname597
Sweden46
Switzerland41
Syria963
Taiwan886
Tajikistan992
Tanzania255
Thailand66
Tonga676
Tunisia216
Turkey90
Turkmenistan993
Uganda256
Ukraine380
United Arab Emirates971
United Kingdom44
Uruguay598
USA and Canada1
Uzbekistan998
Vanuatu678
Venezuela58
Vietnam84
Wallis and Futuna681
Yemen967
Zambia260
Zimbabwe263