--- title: "Get Merchant Acceptor" method: GET path: "/acceptors/{acceptorKey}" tags: ["Merchant Acceptors"] --- # Get Merchant Acceptor `GET /acceptors/{acceptorKey}` ## Request - Base URL: `https://eu-west-1.api.silverflow.com/v1` - URL: `https://eu-west-1.api.silverflow.com/v1/acceptors/{acceptorKey}` - Auth: one of: - HTTP basic - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) This operation returns the active Merchant Acceptor. Requires `acceptors:Get` permission. ## Path parameters - `acceptorKey` string, required: Uniquely identifies a Merchant Acceptor. ## Response `200` The active Acceptor version - Acceptor: A Merchant Acceptor - `key` string, required: Uniquely identifies a Merchant Acceptor. - `status` 'draft' | 'active' | 'archived', required: The status of the Acceptor (version) - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `mid` string, required: As per card network requirements, the Merchant ID assigned by the acquirer must uniquely identify a legal merchant per acquirer BIN. **Note:** For AMEX merchant acceptors, either provide Seller ID of a seller onboarded by a Payfac, or SE number of an AMEX Direct Merchant. | Network | Length | Characters | Pattern | | ------- | ------ | ---------- | --------| | AMEX | 1-20 | alphanumeric | /^[a-zA-Z0-9-_\.]+$/ | | Bancontact | 1-15 | alphanumeric | /^[a-zA-Z0-9-_\.]+$/ | | Diners | 1-15 | alphanumeric | /^[a-zA-Z0-9# -]+$/ | | Discover | 1-15 | alphanumeric | /^[a-zA-Z0-9-_\.]+$/ | | Mastercard | 1-15 | alphanumeric | /^[a-zA-Z0-9-_\.]+$/ | | Visa | 1-15 | alphanumeric | /^[a-zA-Z0-9-_\.]+$/ | - `mcc` string, required: The Merchant category. - `doingBusinessAsName` string, required: Assumed, trade or fictitious name of the merchant. The name will be trimmed if greater than 25 (Visa) or 22 (Mastercard) characters by the card network. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w,\*,\=,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-/]+$` pattern for field input. - `webshopUrl` string: A valid URL - `pointOfSaleAddress` Address: A physical postal address - `countryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `stateOrProvince` string: The state (US) or province (non-US) of the address. Required for US Point of Sale (POS) acceptors. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `city` string, required: The city of the address. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `line1` string, required: Address line 1. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `line2` string: Address line 2. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `postalCode` string, required: The postal code of the address. Clients not enrolled in the "extended character set beta" are still subject to the `^[A-Z0-9]+(\ [A-Z0-9]*)?$` pattern for field input. - `bin` union, required - VisaBin: A Bin is a Bank Identification Number - `network` 'visa', required - `messageSystem` 'DMS' | 'SMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerIdCode` string, required: Acquirer Institution ID code. This field corresponds to the CIB, which usually has the same value as the Bin. - `acquirerBin` string, required: Acquirer Bin. The Bin number as assigned by the card network. - `bid` string, required: Business Identification Number. The BID number as assigned by the card network. - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - MastercardBin: A Bin is a Bank Identification Number - `network` 'mastercard', required - `messageSystem` 'DMS' | 'SMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerIdCode` string, required: Acquirer Institution ID code. For Mastercard, this field corresponds to the Acquirer ICA. - `acquirerBin` string, required: Acquirer Bin. The Bin number as assigned by the card network. For Mastercard, this is also referred to as the Acquirer Reference ID. - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - BancontactBin: A Bin is a Bank Identification Number - `network` 'bancontact', required - `messageSystem` 'DMS' | 'SMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerIdCode` string, required: Acquirer Institution ID code. - `acquirerBin` string, required: Acquirer Bin. The Bin number as assigned by the card network. - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - AmexBin: A Bin is a Bank Identification Number - `network` 'american-express', required - `messageSystem` 'DMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerIdCode` string, required: Acquirer Institution ID code (Submitter ID). For PayFac model, this identifies the Payment Facilitator. - `acquirerBin` union, required - string: SE Number assigned by AMEX for the Payment Facilitator. - string: Acquirer Institution ID code (Submitter ID). For PayFac model, this identifies the Payment Facilitator. - string: Acquirer Institution ID code (Submitter ID). For PayFac model, this identifies the Payment Facilitator. - `authorizationCurrency` 'EUR' | 'USD' | 'AFN' | 'ALL' | 'DZD' | 'AOA' | 'XCD' | 'ARS' | 'AMD' | 'AWG' | 'AUD' | 'AZN' | 'BSD' | 'BHD' | 'BDT' | 'BBD' | 'BYN' | 'BZD' | 'XOF' | 'BMD' | 'INR' | 'BTN' | 'BOB' | 'BAM' | 'BWP' | 'NOK' | 'BRL' | 'BND' | 'BGN' | 'BIF' | 'CVE' | 'KHR' | 'XAF' | 'CAD' | 'KYD' | 'CLP' | 'CNY' | 'CNH' | 'COP' | 'KMF' | 'CDF' | 'NZD' | 'CRC' | 'HRK' | 'CUP' | 'CUC' | 'ANG' | 'CZK' | 'DKK' | 'DJF' | 'DOP' | 'EGP' | 'SVC' | 'ERN' | 'ETB' | 'FKP' | 'FJD' | 'XPF' | 'GMD' | 'GEL' | 'GHS' | 'GIP' | 'GTQ' | 'GBP' | 'GNF' | 'GYD' | 'HTG' | 'HNL' | 'HKD' | 'HUF' | 'ISK' | 'IDR' | 'IRR' | 'IQD' | 'ILS' | 'JMD' | 'JPY' | 'JOD' | 'KZT' | 'KES' | 'KPW' | 'KRW' | 'KWD' | 'KGS' | 'LAK' | 'LBP' | 'LSL' | 'ZAR' | 'LRD' | 'LYD' | 'CHF' | 'MOP' | 'MKD' | 'MGA' | 'MWK' | 'MYR' | 'MVR' | 'MRU' | 'MUR' | 'MXN' | 'MDL' | 'MNT' | 'MAD' | 'MZN' | 'MMK' | 'NAD' | 'NPR' | 'NIO' | 'NGN' | 'OMR' | 'PKR' | 'PAB' | 'PGK' | 'PYG' | 'PEN' | 'PHP' | 'PLN' | 'QAR' | 'RON' | 'RUB' | 'RWF' | 'SHP' | 'WST' | 'STN' | 'SAR' | 'RSD' | 'SCR' | 'SLL' | 'SLE' | 'SGD' | 'SBD' | 'SOS' | 'SSP' | 'LKR' | 'SDG' | 'SRD' | 'SZL' | 'SEK' | 'SYP' | 'TWD' | 'TJS' | 'TZS' | 'THB' | 'TOP' | 'TTD' | 'TND' | 'TRY' | 'TMT' | 'UGX' | 'UAH' | 'AED' | 'UYU' | 'UYW' | 'UZS' | 'VUV' | 'VES' | 'VND' | 'YER' | 'ZMW' | 'ZWL' | 'ZWG': The three-letter ISO code of the currency. **European ISO Currency Codes**
| Country — Currency | Code | Numeric | Minor Units | | ------------------ | ---- | ------- | ----------- | | Åland Islands — Euro | EUR | 978 | 2 | | Andorra — Euro | EUR | 978 | 2 | | Austria — Euro | EUR | 978 | 2 | | Belgium — Euro | EUR | 978 | 2 | | Cyprus — Euro | EUR | 978 | 2 | | Estonia — Euro | EUR | 978 | 2 | | European Union — Euro | EUR | 978 | 2 | | Finland — Euro | EUR | 978 | 2 | | France — Euro | EUR | 978 | 2 | | French Guiana — Euro | EUR | 978 | 2 | | French Southern Territories (The) — Euro | EUR | 978 | 2 | | Germany — Euro | EUR | 978 | 2 | | Greece — Euro | EUR | 978 | 2 | | Guadeloupe — Euro | EUR | 978 | 2 | | Holy See (The) — Euro | EUR | 978 | 2 | | Ireland — Euro | EUR | 978 | 2 | | Italy — Euro | EUR | 978 | 2 | | Latvia — Euro | EUR | 978 | 2 | | Lithuania — Euro | EUR | 978 | 2 | | Luxembourg — Euro | EUR | 978 | 2 | | Malta — Euro | EUR | 978 | 2 | | Martinique — Euro | EUR | 978 | 2 | | Mayotte — Euro | EUR | 978 | 2 | | Monaco — Euro | EUR | 978 | 2 | | Montenegro — Euro | EUR | 978 | 2 | | Netherlands (The) — Euro | EUR | 978 | 2 | | Portugal — Euro | EUR | 978 | 2 | | Réunion — Euro | EUR | 978 | 2 | | Saint Barthélemy — Euro | EUR | 978 | 2 | | Saint Martin (French Part) — Euro | EUR | 978 | 2 | | Saint Pierre And Miquelon — Euro | EUR | 978 | 2 | | San Marino — Euro | EUR | 978 | 2 | | Slovakia — Euro | EUR | 978 | 2 | | Slovenia — Euro | EUR | 978 | 2 | | Spain — Euro | EUR | 978 | 2 |
**US ISO Currency Codes**
| Country — Currency | Code | Numeric | Minor Units | | ------------------ | ---- | ------- | ----------- | | American Samoa — US Dollar | USD | 840 | 2 | | Bonaire, Sint Eustatius And Saba — US Dollar | USD | 840 | 2 | | British Indian Ocean Territory (The) — US Dollar | USD | 840 | 2 | | Ecuador — US Dollar | USD | 840 | 2 | | El Salvador — US Dollar | USD | 840 | 2 | | Guam — US Dollar | USD | 840 | 2 | | Haiti — US Dollar | USD | 840 | 2 | | Marshall Islands (The) — US Dollar | USD | 840 | 2 | | Micronesia (Federated States Of) — US Dollar | USD | 840 | 2 | | Northern Mariana Islands (The) — US Dollar | USD | 840 | 2 | | Palau — US Dollar | USD | 840 | 2 | | Panama — US Dollar | USD | 840 | 2 | | Puerto Rico — US Dollar | USD | 840 | 2 | | Timor-leste — US Dollar | USD | 840 | 2 | | Turks And Caicos Islands (The) — US Dollar | USD | 840 | 2 | | United States Minor Outlying Islands (The) — US Dollar | USD | 840 | 2 | | United States Of America (The) — US Dollar | USD | 840 | 2 | | Virgin Islands (British) — US Dollar | USD | 840 | 2 | | Virgin Islands (U.s.) — US Dollar | USD | 840 | 2 |
**Other ISO Currency Codes**
| Country — Currency | Code | Numeric | Minor Units | | ------------------ | ---- | ------- | ----------- | | Afghanistan — Afghani | AFN | 971 | 2 | | Albania — Lek | ALL | 008 | 2 | | Algeria — Algerian Dinar | DZD | 012 | 2 | | Angola — Kwanza | AOA | 973 | 2 | | Anguilla — East Caribbean Dollar | XCD | 951 | 2 | | Antigua And Barbuda — East Caribbean Dollar | XCD | 951 | 2 | | Argentina — Argentine Peso | ARS | 032 | 2 | | Armenia — Armenian Dram | AMD | 051 | 2 | | Aruba — Aruban Florin | AWG | 533 | 2 | | Australia — Australian Dollar | AUD | 036 | 2 | | Azerbaijan — Azerbaijan Manat | AZN | 944 | 2 | | Bahamas (The) — Bahamian Dollar | BSD | 044 | 2 | | Bahrain — Bahraini Dinar | BHD | 048 | 3 | | Bangladesh — Taka | BDT | 050 | 2 | | Barbados — Barbados Dollar | BBD | 052 | 2 | | Belarus — Belarusian Ruble | BYN | 933 | 2 | | Belize — Belize Dollar | BZD | 084 | 2 | | Benin — CFA Franc BCEAO | XOF | 952 | 0 | | Bermuda — Bermudian Dollar | BMD | 060 | 2 | | Bhutan — Indian Rupee | INR | 356 | 2 | | Bhutan — Ngultrum | BTN | 064 | 2 | | Bolivia (Plurinational State Of) — Boliviano | BOB | 068 | 2 | | Bosnia And Herzegovina — Convertible Mark | BAM | 977 | 2 | | Botswana — Pula | BWP | 072 | 2 | | Bouvet Island — Norwegian Krone | NOK | 578 | 2 | | Brazil — Brazilian Real | BRL | 986 | 2 | | Brunei Darussalam — Brunei Dollar | BND | 096 | 2 | | Bulgaria — Bulgarian Lev | BGN | 975 | 2 | | Burkina Faso — CFA Franc BCEAO | XOF | 952 | 0 | | Burundi — Burundi Franc | BIF | 108 | 0 | | Cabo Verde — Cabo Verde Escudo | CVE | 132 | 2 | | Cambodia — Riel | KHR | 116 | 2 | | Cameroon — CFA Franc BEAC | XAF | 950 | 0 | | Canada — Canadian Dollar | CAD | 124 | 2 | | Cayman Islands (The) — Cayman Islands Dollar | KYD | 136 | 2 | | Central African Republic (The) — CFA Franc BEAC | XAF | 950 | 0 | | Chad — CFA Franc BEAC | XAF | 950 | 0 | | Chile — Chilean Peso | CLP | 152 | 0 | | China — Yuan Renminbi | CNY | 156 | 2 | | China — Yuan Renminbi | CNH | 157 | 2 | | Christmas Island — Australian Dollar | AUD | 036 | 2 | | Cocos (Keeling) Islands (The) — Australian Dollar | AUD | 036 | 2 | | Colombia — Colombian Peso | COP | 170 | 2 | | Comoros (The) — Comorian Franc | KMF | 174 | 0 | | Congo (The Democratic Republic Of The) — Congolese Franc | CDF | 976 | 2 | | Congo (The) — CFA Franc BEAC | XAF | 950 | 0 | | Cook Islands (The) — New Zealand Dollar | NZD | 554 | 2 | | Costa Rica — Costa Rican Colon | CRC | 188 | 2 | | Côte D'ivoire — CFA Franc BCEAO | XOF | 952 | 0 | | Croatia — Kuna | HRK | 191 | 2 | | Cuba — Cuban Peso | CUP | 192 | 2 | | Cuba — Peso Convertible | CUC | 931 | 2 | | Curaçao — Netherlands Antillean Guilder | ANG | 532 | 2 | | Czechia — Czech Koruna | CZK | 203 | 2 | | Denmark — Danish Krone | DKK | 208 | 2 | | Djibouti — Djibouti Franc | DJF | 262 | 0 | | Dominica — East Caribbean Dollar | XCD | 951 | 2 | | Dominican Republic (The) — Dominican Peso | DOP | 214 | 2 | | Egypt — Egyptian Pound | EGP | 818 | 2 | | El Salvador — El Salvador Colon | SVC | 222 | 2 | | Equatorial Guinea — CFA Franc BEAC | XAF | 950 | 0 | | Eritrea — Nakfa | ERN | 232 | 2 | | Ethiopia — Ethiopian Birr | ETB | 230 | 2 | | Falkland Islands (The) [Malvinas] — Falkland Islands Pound | FKP | 238 | 2 | | Faroe Islands (The) — Danish Krone | DKK | 208 | 2 | | Fiji — Fiji Dollar | FJD | 242 | 2 | | French Polynesia — CFP Franc | XPF | 953 | 0 | | Gabon — CFA Franc BEAC | XAF | 950 | 0 | | Gambia (The) — Dalasi | GMD | 270 | 2 | | Georgia — Lari | GEL | 981 | 2 | | Ghana — Ghana Cedi | GHS | 936 | 2 | | Gibraltar — Gibraltar Pound | GIP | 292 | 2 | | Greenland — Danish Krone | DKK | 208 | 2 | | Grenada — East Caribbean Dollar | XCD | 951 | 2 | | Guatemala — Quetzal | GTQ | 320 | 2 | | Guernsey — Pound Sterling | GBP | 826 | 2 | | Guinea — Guinean Franc | GNF | 324 | 0 | | Guinea-bissau — CFA Franc BCEAO | XOF | 952 | 0 | | Guyana — Guyana Dollar | GYD | 328 | 2 | | Haiti — Gourde | HTG | 332 | 2 | | Heard Island And Mcdonald Islands — Australian Dollar | AUD | 036 | 2 | | Honduras — Lempira | HNL | 340 | 2 | | Hong Kong — Hong Kong Dollar | HKD | 344 | 2 | | Hungary — Forint | HUF | 348 | 2 | | Iceland — Iceland Krona | ISK | 352 | 0 | | India — Indian Rupee | INR | 356 | 2 | | Indonesia — Rupiah | IDR | 360 | 2 | | Iran (Islamic Republic Of) — Iranian Rial | IRR | 364 | 2 | | Iraq — Iraqi Dinar | IQD | 368 | 3 | | Isle Of Man — Pound Sterling | GBP | 826 | 2 | | Israel — New Israeli Sheqel | ILS | 376 | 2 | | Jamaica — Jamaican Dollar | JMD | 388 | 2 | | Japan — Yen | JPY | 392 | 0 | | Jersey — Pound Sterling | GBP | 826 | 2 | | Jordan — Jordanian Dinar | JOD | 400 | 3 | | Kazakhstan — Tenge | KZT | 398 | 2 | | Kenya — Kenyan Shilling | KES | 404 | 2 | | Kiribati — Australian Dollar | AUD | 036 | 2 | | Korea (The Democratic People’s Republic Of) — North Korean Won | KPW | 408 | 2 | | Korea (The Republic Of) — Won | KRW | 410 | 0 | | Kuwait — Kuwaiti Dinar | KWD | 414 | 3 | | Kyrgyzstan — Som | KGS | 417 | 2 | | Lao People’s Democratic Republic (The) — Lao Kip | LAK | 418 | 2 | | Lebanon — Lebanese Pound | LBP | 422 | 2 | | Lesotho — Loti | LSL | 426 | 2 | | Lesotho — Rand | ZAR | 710 | 2 | | Liberia — Liberian Dollar | LRD | 430 | 2 | | Libya — Libyan Dinar | LYD | 434 | 3 | | Liechtenstein — Swiss Franc | CHF | 756 | 2 | | Macao — Pataca | MOP | 446 | 2 | | Macedonia (The Former Yugoslav Republic Of) — Denar | MKD | 807 | 2 | | Madagascar — Malagasy Ariary | MGA | 969 | 2 | | Malawi — Malawi Kwacha | MWK | 454 | 2 | | Malaysia — Malaysian Ringgit | MYR | 458 | 2 | | Maldives — Rufiyaa | MVR | 462 | 2 | | Mali — CFA Franc BCEAO | XOF | 952 | 0 | | Mauritania — Ouguiya | MRU | 929 | 2 | | Mauritius — Mauritius Rupee | MUR | 480 | 2 | | Mexico — Mexican Peso | MXN | 484 | 2 | | Moldova (The Republic Of) — Moldovan Leu | MDL | 498 | 2 | | Mongolia — Tugrik | MNT | 496 | 2 | | Montserrat — East Caribbean Dollar | XCD | 951 | 2 | | Morocco — Moroccan Dirham | MAD | 504 | 2 | | Mozambique — Mozambique Metical | MZN | 943 | 2 | | Myanmar — Kyat | MMK | 104 | 2 | | Namibia — Namibia Dollar | NAD | 516 | 2 | | Namibia — Rand | ZAR | 710 | 2 | | Nauru — Australian Dollar | AUD | 036 | 2 | | Nepal — Nepalese Rupee | NPR | 524 | 2 | | New Caledonia — CFP Franc | XPF | 953 | 0 | | New Zealand — New Zealand Dollar | NZD | 554 | 2 | | Nicaragua — Cordoba Oro | NIO | 558 | 2 | | Niger (The) — CFA Franc BCEAO | XOF | 952 | 0 | | Nigeria — Naira | NGN | 566 | 2 | | Niue — New Zealand Dollar | NZD | 554 | 2 | | Norfolk Island — Australian Dollar | AUD | 036 | 2 | | Norway — Norwegian Krone | NOK | 578 | 2 | | Oman — Rial Omani | OMR | 512 | 3 | | Pakistan — Pakistan Rupee | PKR | 586 | 2 | | Panama — Balboa | PAB | 590 | 2 | | Papua New Guinea — Kina | PGK | 598 | 2 | | Paraguay — Guarani | PYG | 600 | 0 | | Peru — Sol | PEN | 604 | 2 | | Philippines (The) — Philippine Peso | PHP | 608 | 2 | | Pitcairn — New Zealand Dollar | NZD | 554 | 2 | | Poland — Zloty | PLN | 985 | 2 | | Qatar — Qatari Rial | QAR | 634 | 2 | | Romania — Romanian Leu | RON | 946 | 2 | | Russian Federation (The) — Russian Ruble | RUB | 643 | 2 | | Rwanda — Rwanda Franc | RWF | 646 | 0 | | Saint Helena, Ascension And Tristan Da Cunha — Saint Helena Pound | SHP | 654 | 2 | | Saint Kitts And Nevis — East Caribbean Dollar | XCD | 951 | 2 | | Saint Lucia — East Caribbean Dollar | XCD | 951 | 2 | | Saint Vincent And The Grenadines — East Caribbean Dollar | XCD | 951 | 2 | | Samoa — Tala | WST | 882 | 2 | | Sao Tome And Principe — Dobra | STN | 930 | 2 | | Saudi Arabia — Saudi Riyal | SAR | 682 | 2 | | Senegal — CFA Franc BCEAO | XOF | 952 | 0 | | Serbia — Serbian Dinar | RSD | 941 | 2 | | Seychelles — Seychelles Rupee | SCR | 690 | 2 | | Sierra Leone — Leone | SLL | 694 | 2 | | Sierra Leone — Leone | SLE | 925 | 2 | | Singapore — Singapore Dollar | SGD | 702 | 2 | | Sint Maarten (Dutch Part) — Netherlands Antillean Guilder | ANG | 532 | 2 | | Solomon Islands — Solomon Islands Dollar | SBD | 090 | 2 | | Somalia — Somali Shilling | SOS | 706 | 2 | | South Africa — Rand | ZAR | 710 | 2 | | South Sudan — South Sudanese Pound | SSP | 728 | 2 | | Sri Lanka — Sri Lanka Rupee | LKR | 144 | 2 | | Sudan (The) — Sudanese Pound | SDG | 938 | 2 | | Suriname — Surinam Dollar | SRD | 968 | 2 | | Svalbard And Jan Mayen — Norwegian Krone | NOK | 578 | 2 | | Eswatini — Lilangeni | SZL | 748 | 2 | | Sweden — Swedish Krona | SEK | 752 | 2 | | Switzerland — Swiss Franc | CHF | 756 | 2 | | Syrian Arab Republic — Syrian Pound | SYP | 760 | 2 | | Taiwan (Province Of China) — New Taiwan Dollar | TWD | 901 | 2 | | Tajikistan — Somoni | TJS | 972 | 2 | | Tanzania, United Republic Of — Tanzanian Shilling | TZS | 834 | 2 | | Thailand — Baht | THB | 764 | 2 | | Togo — CFA Franc BCEAO | XOF | 952 | 0 | | Tokelau — New Zealand Dollar | NZD | 554 | 2 | | Tonga — Pa’anga | TOP | 776 | 2 | | Trinidad And Tobago — Trinidad and Tobago Dollar | TTD | 780 | 2 | | Tunisia — Tunisian Dinar | TND | 788 | 3 | | Turkey — Turkish Lira | TRY | 949 | 2 | | Turkmenistan — Turkmenistan New Manat | TMT | 934 | 2 | | Tuvalu — Australian Dollar | AUD | 036 | 2 | | Uganda — Uganda Shilling | UGX | 800 | 0 | | Ukraine — Hryvnia | UAH | 980 | 2 | | United Arab Emirates (The) — UAE Dirham | AED | 784 | 2 | | United Kingdom Of Great Britain And Northern Ireland (The) — Pound Sterling | GBP | 826 | 2 | | Uruguay — Peso Uruguayo | UYU | 858 | 2 | | Uruguay — Unidad Previsional | UYW | 927 | 4 | | Uzbekistan — Uzbekistan Sum | UZS | 860 | 2 | | Vanuatu — Vatu | VUV | 548 | 0 | | Venezuela (Bolivarian Republic Of) — Bolívar Soberano | VES | 928 | 2 | | Viet Nam — Dong | VND | 704 | 0 | | Wallis And Futuna — CFP Franc | XPF | 953 | 0 | | Western Sahara — Moroccan Dirham | MAD | 504 | 2 | | Yemen — Yemeni Rial | YER | 886 | 2 | | Zambia — Zambian Kwacha | ZMW | 967 | 2 | | Zimbabwe — Zimbabwe Dollar | ZWL | 932 | 2 | | Zimbabwe — Zimbabwe Gold | ZWG | 924 | 2 |
- `amexModel` 'payfac' | 'direct_merchant' | 'payment_designation': The AMEX business model. In the PayFac model, authorization is performed using the SE Number on the BIN. In the Direct Merchant or Payment Designation model, authorization is performed using the SE Number on the Acceptor. If `amexModel` is undefined, the AMEX Bin is treated as a PayFac Bin by default. - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - DiscoverBin: A Bin is a Bank Identification Number - `network` 'discover', required - `messageSystem` 'DMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerIdCode` string, required: Acquirer Institution ID code. - `acquirerBin` string, required: Acquirer Bin. The Bin number as assigned by the card network. - `isoId` string: Unique number assigned by Discover to a certified ISO. This field is mandatory if the direct Merchant relationship is maintained by an ISO - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - DinersBin: A Bin is a Bank Identification Number - `network` 'diners', required - `messageSystem` 'DMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerBin` string, required: Acquirer Institution ID code. For Diners, this field corresponds to the IIC number. - `acquirerIdCode` string, required: Acquirer Institution ID code. For Diners, this field corresponds to the IIC number. - `dxsCode` string, required: The dxsCode is provided to acquirers by Diners during onboarding. A unique dxsCode is provided for each IIC. - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - UnionpayBin: A Bin is a Bank Identification Number - `network` 'unionpay', required - `messageSystem` 'DMS', required: Determines the message structure and Data Element definitions for card network. - `acquirerIdCode` string, required: Acquirer Institution ID code. For Union Pay, this field corresponds to the IIN number and it is a unique value for the Bin. - `key` string, required: A key assigned by Silverflow to uniquely identify a Bin. - `status` 'active' | 'archived', required: The status of the object - `description` string, required: Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `acquirerAgentKey` string: Acquirer Agent Key shows the owner agent Key of the Bin. - `acquirerCountryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `shared` boolean, required: Indicates if this Bin is shared across agents. If so the MIDs are restricted in length to `11`. - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - `merchant` Merchant, required: A Merchant acts as a template - `key` string, required: Uniquely identifies a Merchant - `status` 'active' | 'archived', required: The status of the Merchant - `merchantReference` string: Merchant reference number used by the Agent. Must not start with "mct-". - `agentKey` string, required: Uniquely identifies an Agent - `name` string, required: The display name of the Merchant. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-\/]+$` pattern for field input. - `description` string: The description of the Merchant. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w +=.,:;!?$@()-]+$` pattern for field input. - `legalName` string, required: The legal name of the Merchant. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-\/]+$` pattern for field input. - `registeredAddress` Address, required: A physical postal address - `countryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `stateOrProvince` string: The state (US) or province (non-US) of the address. Required for US Point of Sale (POS) acceptors. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `city` string, required: The city of the address. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `line1` string, required: Address line 1. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `line2` string: Address line 2. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `postalCode` string, required: The postal code of the address. Clients not enrolled in the "extended character set beta" are still subject to the `^[A-Z0-9]+(\ [A-Z0-9]*)?$` pattern for field input. - `customerInquiry` string, required: An international phone number - `websiteUrl` string, required: A valid URL - `tags` Tags: Optional tags provided by the agent to tag the object for maintainability. Tags can be used filtering and sorting on the list views of entities. Tag object can contain 10 properties at most. A valid tag-key must: - contain only a-z, 0-9, "_" characters - first character should be a letter - be at least 1 character long - be no longer than 24 characters - not start with "sf_" - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - `taxRegistrationId` string: A unique identifier assigned to individuals or entities for tax-related purposes. The format, name and use of this id may vary depending on the country and card network.
**Visa** requires all acquirers to include the SIRET for France or the Tax Identification Number for Belgium and Luxembourg for all domestic transactions.
**Mastercard** and **Discover** require the Tax Id Number in the US for commercial card transactions. - `sellerEmail` string: A valid email address - `businessType` 'corporation' | 'sole_proprietorship' | 'partnership' | 'non_profit_organization' | 'government_agency' | 'limited_liability_company': The business type of the merchant. Specifying the businessType for your legal entity may qualify the merchant to benefit from lower interchange fees in the United States (Mastercard and Visa).
For US merchants, **Mastercard** requires this field for commercial card transactions. If none of the values closely match your business type please contact your Technical Account Manager. - `networkAssignedId` string: Unique ID assigned by the card network for the merchant. Used for example for Private Label transactions or large merchants. | Network | Length | Characters | | ------- | ------ | ---------- | | Mastercard | 6 | alpha numeric | | Visa | 10 | numeric | | Bancontact | 6 | numeric | - `acquirerOrPayFacBusinessId` string: Unique ID assigned by the card network for the Payment Facilitator or the acquirer (VISA) that signed up the merchant. **Note:** Mastercard only uses numeric characters in this field, Visa uses alphanumeric characters. - `subMerchantId` string: Unique ID assigned by the acquirer or Payment Facilitator to the subMerchant. - `subMerchantAddress` Address: A physical postal address - `countryCode` CountryCode, required - `alpha3` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `alpha2` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `numeric` string, required: The ISO code of the country. **European ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Åland Islands | AX | 248 | | Andorra | AD | 020 | | Austria | AT | 040 | | Belgium | BE | 056 | | Cyprus | CY | 196 | | Estonia | EE | 233 | | | Finland | FI | 246 | | France | FR | 250 | | French Guiana | GF | 254 | | French Southern Territories | TF | 260 | | Germany | DE | 280 | | Greece | GR | 300 | | Guadeloupe | GP | 312 | | Ireland | IE | 372 | | Italy | IT | 380 | | Kosovo, United Nations Mission in Kosovo (UNMIK) | QZ | 900 | | Latvia | LV | 428 | | Lithuania | LT | 440 | | Luxembourg | LU | 442 | | Malta | MT | 470 | | Martinique | MQ | 474 | | Mayotte | YT | 175 | | Monaco | MC | 492 | | Montenegro | ME | 499 | | Netherlands | NL | 528 | | Portugal | PT | 620 | | Reunion | RE | 638 | | Saint Barthélemy | BL | 652 | | Saint Martin (French Part) | MF | 663 | | San Marino | SM | 674 | | Slovakia | SK | 703 | | Slovenia | SI | 705 | | Spain | ES | 724 | | St. Pierre and Miquelon | PM | 666 | | Vatican City State (Holy See) | VA | 336 |
**US ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | American Samoa | AS | 016 | | Bonaire, St. Eusasius and Saba | BQ | 535 | | British Indian Ocean Territory | IO | 086 | | Ecuador | EC | 218 | | Guam | GU | 316 | | Marshall Islands | MH | 584 | | Micronesia, Federated States of | FM | 583 | | Northern Mariana Islands | MP | 580 | | Palau | PW | 585 | | Palestine, State of | PS | 275 | | Puerto Rico | PR | 630 | | Timor-Leste | TP | 626 | | Turks and Caicos Islands | TC | 796 | | U.S. Minor Outlying Islands | UM | 581 | | United States | US | 840 | | Virgin Islands, British | VG | 092 | | Virgin Islands, U.S. | VI | 850 |
**Other ISO Country Codes**
| Country | Alpha-2 code | Numeric | | ------- | ------------ | ------- | | Afghanistan | AF | 004 | | Albania | AL | 008 | | Algeria | DZ | 012 | | Angola | AO | 024 | | Anguilla | AI | 660 | | Antarctica | AQ | 010 | | Antigua and Barbuda | AG | 028 | | Argentina | AR | 032 | | Armenia | AM | 051 | | Aruba | AW | 533 | | Australia | AU | 036 | | Azerbaijan | AZ | 031 | | Bahamas | BS | 044 | | Bahrain | BH | 048 | | Bangladesh | BD | 050 | | Barbados | BB | 052 | | Belarus | BR | 112 | | Belize | BZ | 084 | | Benin | BJ | 204 | | Bermuda | BM | 060 | | Bhutan | BT | 064 | | Bolivia, Plurinational State of | BO | 068 | | Bosnia and Herzegovina | BA | 070 | | Botswana | BW | 072 | | Bouvet Island | BV | 074 | | Brazil | BR | 076 | | Brunei Darussalam | BN | 096 | | Bulgaria | BG | 100 | | Burkina Faso | BF | 854 | | Burundi | BI | 108 | | Cambodia | KH | 116 | | Cameroon | CM | 120 | | Canada | CA | 124 | | Cape Verde | CV | 132 | | Cayman Islands | KY | 136 | | Central African Republic | CF | 140 | | Chad | TD | 148 | | Chile | CL | 152 | | China | CN | 156 | | Christmas Island | CX | 162 | | Cocos (Keeling) Islands | CC | 166 | | Colombia | CO | 170 | | Comoros | KM | 174 | | Congo | CG | 178 | | Cook Islands | CK | 184 | | Costa Rica | CR | 188 | | Côte D'Ivoire | CI | 384 | | Croatia | HR | 191 | | Cuba | CU | 192 | | Curacao | CW | 531 | | Czech Republic | CZ | 203 | | Democratic Republic of the Congo | CD | 180 | | Denmark | DK | 208 | | Djibouti | DJ | 262 | | Dominica | DM | 212 | | Dominican Republic | DO | 214 | | Egypt | EG | 818 | | El Salvador | SV | 222 | | Equatorial Guinea | GQ | 226 | | Eritrea | ER | 232 | | Ethiopia | ET | 230 | | Falkland Islands (Malvinas) | FK | 238 | | Faroe Islands | FO | 234 | | Fiji | FJ | 242 | | French Polynesia | PF | 258 | | Gabon | GA | 266 | | Gambia | GM | 270 | | Georgia | GE | 268 | | Ghana | GH | 288 | | Gibraltar | GI | 292 | | Greenland | GL | 304 | | Grenada | GD | 308 | | Guatemala | GT | 320 | | Guernsey | GG | 831 | | Guinea | GN | 324 | | Guinea-Bissau | GW | 624 | | Guyana | GY | 328 | | Haiti | HT | 332 | | Heard and McDonald Islands | HM | 334 | | Honduras | HN | 340 | | Hong Kong | HK | 344 | | Hungary | HU | 348 | | Iceland | IS | 352 | | India | IN | 356 | | Indonesia | ID | 360 | | Iraq | IQ | 368 | | Isle of Man | IM | 833 | | Israel | IL | 376 | | Jamaica | JM | 388 | | Japan | JP | 392 | | Jersey | JE | 832 | | Jordan | JO | 400 | | Kazakhstan | KZ | 398 | | Kenya | KE | 404 | | Kiribati | KI | 296 | | Korea, Republic of | KR | 410 | | Kuwait | KW | 414 | | Kyrgyzstan | KG | 417 | | Lao People's Democratic Republic | LA | 418 | | Lebanon | LB | 422 | | Lesotho | LS | 426 | | Liberia | LR | 430 | | Libyan Arab Jamahiriya | LY | 434 | | Liechtenstein | LI | 438 | | Macao | MO | 446 | | Macedonia | MK | 807 | | Madagascar | MG | 450 | | Malawi | MW | 454 | | Malaysia | MY | 458 | | Maldives | MV | 462 | | Mali | ML | 466 | | Mauritania | MR | 478 | | Mauritius | MU | 480 | | Mexico | MX | 484 | | Moldova, Republic of | MD | 498 | | Mongolia | MN | 496 | | Montserrat | MS | 500 | | Morocco | MA | 504 | | Mozambique | MZ | 508 | | Myanmar (effective 1 November 2012) | MM | 104 | | Namibia | NA | 516 | | Nauru | NR | 520 | | Nepal | NP | 524 | | Netherlands Antilles | AN | 530 | | New Caledonia | NC | 540 | | New Zealand | NZ | 554 | | Nicaragua | NI | 558 | | Niger | NE | 562 | | Nigeria | NG | 566 | | Niue | NU | 570 | | Norfolk Island | NF | 574 | | Norway | NO | 578 | | Oman | OM | 512 | | Pakistan | PK | 586 | | Panama | PA | 591 | | Papua New Guinea | PG | 598 | | Paraguay | PY | 600 | | Peru | PE | 604 | | Philippines | PH | 608 | | Pitcairn | PN | 612 | | Poland | PL | 616 | | Qatar | QA | 634 | | Republic of South Sudan | SS | 728 | | Romania | RO | 642 | | Russian Federation | RU | 643 | | Rwanda | RW | 646 | | Samoa | WS | 882 | | Sao Tome and Principe | ST | 678 | | Saudi Arabia | SA | 682 | | Senegal | SN | 686 | | Serbia | RS | 688 | | Seychelles | SC | 690 | | Sierra Leone | SL | 694 | | Singapore | SG | 702 | | Sint Maarten (Dutch Part) | SX | 534 | | Solomon Islands | SB | 090 | | Somalia | SO | 706 | | South Africa | ZA | 710 | | South Georgia and the South Sandwich Islands | GS | 239 | | Sri Lanka | LK | 144 | | Saint Helena, Ascension and Tristan Da Cunha | SH | 654 | | St. Kitts and Nevis | KN | 659 | | St. Lucia | LC | 662 | | St. Vincent and the Grenadines | VC | 670 | | Suriname | SR | 740 | | Svalbard and Jan Mayen | SJ | 744 | | Swaziland | SZ | 748 | | Sweden | SE | 752 | | Switzerland | CH | 756 | | Taiwan | TW | 158 | | Tajikistan | TJ | 762 | | Tanzania, United Republic of | TZ | 834 | | Thailand | TH | 764 | | Togo | TG | 768 | | Tokelau | TK | 772 | | Tonga | TO | 776 | | Trinidad and Tobago | TT | 780 | | Tunisia | TN | 788 | | Turkey | TR | 792 | | Turkmenistan | TM | 795 | | Tuvalu | TV | 798 | | Uganda | UG | 800 | | Ukraine | UA | 804 | | United Arab Emirates | AE | 784 | | United Kingdom | GB | 826 | | Uruguay | UY | 858 | | Uzbekistan | UZ | 860 | | Vanuatu | VU | 548 | | Venezuela, Bolivarian Republic of | VE | 862 | | Vietnam | VN | 704 | | Wallis and Futuna | WF | 876 | | Western Sahara | EH | 732 | | Yemen | YE | 886 | | Zambia | ZM | 894 | | Zimbabwe | ZW | 716 |
- `stateOrProvince` string: The state (US) or province (non-US) of the address. Required for US Point of Sale (POS) acceptors. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `city` string, required: The city of the address. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `line1` string, required: Address line 1. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `line2` string: Address line 2. Clients not enrolled in the "extended character set beta" are still subject to the `^[\w ,\.\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF-]+$` pattern for field input. - `postalCode` string, required: The postal code of the address. Clients not enrolled in the "extended character set beta" are still subject to the `^[A-Z0-9]+(\ [A-Z0-9]*)?$` pattern for field input. - `isoId` string: Unique ID assigned by the card network for the Independent Sales Organization. MASTERCARD - `gatewayId` string: Merchant Payment Gateway ID (MPG ID). MPG ID is assigned by Mastercard at the time of registration of the MPG as a Service Provider. The value `999998` must be used for MGP ID field if the MPG is wholly owned by the Acquirer. The value `999997` must be used in the MPG ID field if the Merchant uses no gateway and connects directly to the Acquirer. In case no value is provided, `999998` is used by Silverflow where applicable. MASTERCARD - `restrictions` AcceptorRestriction[]: This field is deprecated. The `chargesBlocked` property on the MerchantAcceptor serves as its replacement. - `suspendPayouts` boolean: (Coming soon) When set to true payment instructions for this merchant acceptor will not be sent until set to false again. - `blockCharges` boolean: This field is deprecated. The `chargesBlocked` property on the MerchantAcceptor serves as its replacement. - `chargesBlocked` boolean: A value of `true` prohibits charges and card management actions from being created using this Acceptor. If the property is absent upon Acceptor creation a value of `false` is assumed. - `foreignRetailer` boolean: Applicable for Visa Marketplace and Ramp Provider programs only. Indicates if the end merchant is in a different country than the Marketplace or Ramp Provider. VISA - `marketplaceId` string: Visa provided ID required for marketplaces. If provided, `rampProviderId` must not be provided. VISA - `rampProviderId` string: Visa provided ID required for ramp providers. If provided, `marketplaceId` must not be provided. VISA - `tags` Tags: Optional tags provided by the agent to tag the object for maintainability. Tags can be used filtering and sorting on the list views of entities. Tag object can contain 10 properties at most. A valid tag-key must: - contain only a-z, 0-9, "_" characters - first character should be a letter - be at least 1 character long - be no longer than 24 characters - not start with "sf_" - `disputeHandling` DisputeHandling: Dispute handling settings - `autoDefense` boolean, required: When autoDefense is set to true, disputes will be auto defended if there is a matching auto-defense rule present. VISA MASTERCARD - `created` string, date-time, required: The date and time this object was created - `lastModified` string, date-time: The date and time this object was last modified - `version` integer, required: The version of this object - `reference` string: User-specified reference. - `route` string: An optional route key to force route charges - `merchantVolumeIndicator` string: The Merchant Volume Indicator (MVI) is a Visa assigned field used to classify merchants based on their Visa transaction volume. This field is optional for Visa Merchant Acceptors in the US region. VISA - `authorizationCurrency` 'EUR' | 'USD' | 'AFN' | 'ALL' | 'DZD' | 'AOA' | 'XCD' | 'ARS' | 'AMD' | 'AWG' | 'AUD' | 'AZN' | 'BSD' | 'BHD' | 'BDT' | 'BBD' | 'BYN' | 'BZD' | 'XOF' | 'BMD' | 'INR' | 'BTN' | 'BOB' | 'BAM' | 'BWP' | 'NOK' | 'BRL' | 'BND' | 'BGN' | 'BIF' | 'CVE' | 'KHR' | 'XAF' | 'CAD' | 'KYD' | 'CLP' | 'CNY' | 'CNH' | 'COP' | 'KMF' | 'CDF' | 'NZD' | 'CRC' | 'HRK' | 'CUP' | 'CUC' | 'ANG' | 'CZK' | 'DKK' | 'DJF' | 'DOP' | 'EGP' | 'SVC' | 'ERN' | 'ETB' | 'FKP' | 'FJD' | 'XPF' | 'GMD' | 'GEL' | 'GHS' | 'GIP' | 'GTQ' | 'GBP' | 'GNF' | 'GYD' | 'HTG' | 'HNL' | 'HKD' | 'HUF' | 'ISK' | 'IDR' | 'IRR' | 'IQD' | 'ILS' | 'JMD' | 'JPY' | 'JOD' | 'KZT' | 'KES' | 'KPW' | 'KRW' | 'KWD' | 'KGS' | 'LAK' | 'LBP' | 'LSL' | 'ZAR' | 'LRD' | 'LYD' | 'CHF' | 'MOP' | 'MKD' | 'MGA' | 'MWK' | 'MYR' | 'MVR' | 'MRU' | 'MUR' | 'MXN' | 'MDL' | 'MNT' | 'MAD' | 'MZN' | 'MMK' | 'NAD' | 'NPR' | 'NIO' | 'NGN' | 'OMR' | 'PKR' | 'PAB' | 'PGK' | 'PYG' | 'PEN' | 'PHP' | 'PLN' | 'QAR' | 'RON' | 'RUB' | 'RWF' | 'SHP' | 'WST' | 'STN' | 'SAR' | 'RSD' | 'SCR' | 'SLL' | 'SLE' | 'SGD' | 'SBD' | 'SOS' | 'SSP' | 'LKR' | 'SDG' | 'SRD' | 'SZL' | 'SEK' | 'SYP' | 'TWD' | 'TJS' | 'TZS' | 'THB' | 'TOP' | 'TTD' | 'TND' | 'TRY' | 'TMT' | 'UGX' | 'UAH' | 'AED' | 'UYU' | 'UYW' | 'UZS' | 'VUV' | 'VES' | 'VND' | 'YER' | 'ZMW' | 'ZWL' | 'ZWG': The three-letter ISO code of the currency. **European ISO Currency Codes**
| Country — Currency | Code | Numeric | Minor Units | | ------------------ | ---- | ------- | ----------- | | Åland Islands — Euro | EUR | 978 | 2 | | Andorra — Euro | EUR | 978 | 2 | | Austria — Euro | EUR | 978 | 2 | | Belgium — Euro | EUR | 978 | 2 | | Cyprus — Euro | EUR | 978 | 2 | | Estonia — Euro | EUR | 978 | 2 | | European Union — Euro | EUR | 978 | 2 | | Finland — Euro | EUR | 978 | 2 | | France — Euro | EUR | 978 | 2 | | French Guiana — Euro | EUR | 978 | 2 | | French Southern Territories (The) — Euro | EUR | 978 | 2 | | Germany — Euro | EUR | 978 | 2 | | Greece — Euro | EUR | 978 | 2 | | Guadeloupe — Euro | EUR | 978 | 2 | | Holy See (The) — Euro | EUR | 978 | 2 | | Ireland — Euro | EUR | 978 | 2 | | Italy — Euro | EUR | 978 | 2 | | Latvia — Euro | EUR | 978 | 2 | | Lithuania — Euro | EUR | 978 | 2 | | Luxembourg — Euro | EUR | 978 | 2 | | Malta — Euro | EUR | 978 | 2 | | Martinique — Euro | EUR | 978 | 2 | | Mayotte — Euro | EUR | 978 | 2 | | Monaco — Euro | EUR | 978 | 2 | | Montenegro — Euro | EUR | 978 | 2 | | Netherlands (The) — Euro | EUR | 978 | 2 | | Portugal — Euro | EUR | 978 | 2 | | Réunion — Euro | EUR | 978 | 2 | | Saint Barthélemy — Euro | EUR | 978 | 2 | | Saint Martin (French Part) — Euro | EUR | 978 | 2 | | Saint Pierre And Miquelon — Euro | EUR | 978 | 2 | | San Marino — Euro | EUR | 978 | 2 | | Slovakia — Euro | EUR | 978 | 2 | | Slovenia — Euro | EUR | 978 | 2 | | Spain — Euro | EUR | 978 | 2 |
**US ISO Currency Codes**
| Country — Currency | Code | Numeric | Minor Units | | ------------------ | ---- | ------- | ----------- | | American Samoa — US Dollar | USD | 840 | 2 | | Bonaire, Sint Eustatius And Saba — US Dollar | USD | 840 | 2 | | British Indian Ocean Territory (The) — US Dollar | USD | 840 | 2 | | Ecuador — US Dollar | USD | 840 | 2 | | El Salvador — US Dollar | USD | 840 | 2 | | Guam — US Dollar | USD | 840 | 2 | | Haiti — US Dollar | USD | 840 | 2 | | Marshall Islands (The) — US Dollar | USD | 840 | 2 | | Micronesia (Federated States Of) — US Dollar | USD | 840 | 2 | | Northern Mariana Islands (The) — US Dollar | USD | 840 | 2 | | Palau — US Dollar | USD | 840 | 2 | | Panama — US Dollar | USD | 840 | 2 | | Puerto Rico — US Dollar | USD | 840 | 2 | | Timor-leste — US Dollar | USD | 840 | 2 | | Turks And Caicos Islands (The) — US Dollar | USD | 840 | 2 | | United States Minor Outlying Islands (The) — US Dollar | USD | 840 | 2 | | United States Of America (The) — US Dollar | USD | 840 | 2 | | Virgin Islands (British) — US Dollar | USD | 840 | 2 | | Virgin Islands (U.s.) — US Dollar | USD | 840 | 2 |
**Other ISO Currency Codes**
| Country — Currency | Code | Numeric | Minor Units | | ------------------ | ---- | ------- | ----------- | | Afghanistan — Afghani | AFN | 971 | 2 | | Albania — Lek | ALL | 008 | 2 | | Algeria — Algerian Dinar | DZD | 012 | 2 | | Angola — Kwanza | AOA | 973 | 2 | | Anguilla — East Caribbean Dollar | XCD | 951 | 2 | | Antigua And Barbuda — East Caribbean Dollar | XCD | 951 | 2 | | Argentina — Argentine Peso | ARS | 032 | 2 | | Armenia — Armenian Dram | AMD | 051 | 2 | | Aruba — Aruban Florin | AWG | 533 | 2 | | Australia — Australian Dollar | AUD | 036 | 2 | | Azerbaijan — Azerbaijan Manat | AZN | 944 | 2 | | Bahamas (The) — Bahamian Dollar | BSD | 044 | 2 | | Bahrain — Bahraini Dinar | BHD | 048 | 3 | | Bangladesh — Taka | BDT | 050 | 2 | | Barbados — Barbados Dollar | BBD | 052 | 2 | | Belarus — Belarusian Ruble | BYN | 933 | 2 | | Belize — Belize Dollar | BZD | 084 | 2 | | Benin — CFA Franc BCEAO | XOF | 952 | 0 | | Bermuda — Bermudian Dollar | BMD | 060 | 2 | | Bhutan — Indian Rupee | INR | 356 | 2 | | Bhutan — Ngultrum | BTN | 064 | 2 | | Bolivia (Plurinational State Of) — Boliviano | BOB | 068 | 2 | | Bosnia And Herzegovina — Convertible Mark | BAM | 977 | 2 | | Botswana — Pula | BWP | 072 | 2 | | Bouvet Island — Norwegian Krone | NOK | 578 | 2 | | Brazil — Brazilian Real | BRL | 986 | 2 | | Brunei Darussalam — Brunei Dollar | BND | 096 | 2 | | Bulgaria — Bulgarian Lev | BGN | 975 | 2 | | Burkina Faso — CFA Franc BCEAO | XOF | 952 | 0 | | Burundi — Burundi Franc | BIF | 108 | 0 | | Cabo Verde — Cabo Verde Escudo | CVE | 132 | 2 | | Cambodia — Riel | KHR | 116 | 2 | | Cameroon — CFA Franc BEAC | XAF | 950 | 0 | | Canada — Canadian Dollar | CAD | 124 | 2 | | Cayman Islands (The) — Cayman Islands Dollar | KYD | 136 | 2 | | Central African Republic (The) — CFA Franc BEAC | XAF | 950 | 0 | | Chad — CFA Franc BEAC | XAF | 950 | 0 | | Chile — Chilean Peso | CLP | 152 | 0 | | China — Yuan Renminbi | CNY | 156 | 2 | | China — Yuan Renminbi | CNH | 157 | 2 | | Christmas Island — Australian Dollar | AUD | 036 | 2 | | Cocos (Keeling) Islands (The) — Australian Dollar | AUD | 036 | 2 | | Colombia — Colombian Peso | COP | 170 | 2 | | Comoros (The) — Comorian Franc | KMF | 174 | 0 | | Congo (The Democratic Republic Of The) — Congolese Franc | CDF | 976 | 2 | | Congo (The) — CFA Franc BEAC | XAF | 950 | 0 | | Cook Islands (The) — New Zealand Dollar | NZD | 554 | 2 | | Costa Rica — Costa Rican Colon | CRC | 188 | 2 | | Côte D'ivoire — CFA Franc BCEAO | XOF | 952 | 0 | | Croatia — Kuna | HRK | 191 | 2 | | Cuba — Cuban Peso | CUP | 192 | 2 | | Cuba — Peso Convertible | CUC | 931 | 2 | | Curaçao — Netherlands Antillean Guilder | ANG | 532 | 2 | | Czechia — Czech Koruna | CZK | 203 | 2 | | Denmark — Danish Krone | DKK | 208 | 2 | | Djibouti — Djibouti Franc | DJF | 262 | 0 | | Dominica — East Caribbean Dollar | XCD | 951 | 2 | | Dominican Republic (The) — Dominican Peso | DOP | 214 | 2 | | Egypt — Egyptian Pound | EGP | 818 | 2 | | El Salvador — El Salvador Colon | SVC | 222 | 2 | | Equatorial Guinea — CFA Franc BEAC | XAF | 950 | 0 | | Eritrea — Nakfa | ERN | 232 | 2 | | Ethiopia — Ethiopian Birr | ETB | 230 | 2 | | Falkland Islands (The) [Malvinas] — Falkland Islands Pound | FKP | 238 | 2 | | Faroe Islands (The) — Danish Krone | DKK | 208 | 2 | | Fiji — Fiji Dollar | FJD | 242 | 2 | | French Polynesia — CFP Franc | XPF | 953 | 0 | | Gabon — CFA Franc BEAC | XAF | 950 | 0 | | Gambia (The) — Dalasi | GMD | 270 | 2 | | Georgia — Lari | GEL | 981 | 2 | | Ghana — Ghana Cedi | GHS | 936 | 2 | | Gibraltar — Gibraltar Pound | GIP | 292 | 2 | | Greenland — Danish Krone | DKK | 208 | 2 | | Grenada — East Caribbean Dollar | XCD | 951 | 2 | | Guatemala — Quetzal | GTQ | 320 | 2 | | Guernsey — Pound Sterling | GBP | 826 | 2 | | Guinea — Guinean Franc | GNF | 324 | 0 | | Guinea-bissau — CFA Franc BCEAO | XOF | 952 | 0 | | Guyana — Guyana Dollar | GYD | 328 | 2 | | Haiti — Gourde | HTG | 332 | 2 | | Heard Island And Mcdonald Islands — Australian Dollar | AUD | 036 | 2 | | Honduras — Lempira | HNL | 340 | 2 | | Hong Kong — Hong Kong Dollar | HKD | 344 | 2 | | Hungary — Forint | HUF | 348 | 2 | | Iceland — Iceland Krona | ISK | 352 | 0 | | India — Indian Rupee | INR | 356 | 2 | | Indonesia — Rupiah | IDR | 360 | 2 | | Iran (Islamic Republic Of) — Iranian Rial | IRR | 364 | 2 | | Iraq — Iraqi Dinar | IQD | 368 | 3 | | Isle Of Man — Pound Sterling | GBP | 826 | 2 | | Israel — New Israeli Sheqel | ILS | 376 | 2 | | Jamaica — Jamaican Dollar | JMD | 388 | 2 | | Japan — Yen | JPY | 392 | 0 | | Jersey — Pound Sterling | GBP | 826 | 2 | | Jordan — Jordanian Dinar | JOD | 400 | 3 | | Kazakhstan — Tenge | KZT | 398 | 2 | | Kenya — Kenyan Shilling | KES | 404 | 2 | | Kiribati — Australian Dollar | AUD | 036 | 2 | | Korea (The Democratic People’s Republic Of) — North Korean Won | KPW | 408 | 2 | | Korea (The Republic Of) — Won | KRW | 410 | 0 | | Kuwait — Kuwaiti Dinar | KWD | 414 | 3 | | Kyrgyzstan — Som | KGS | 417 | 2 | | Lao People’s Democratic Republic (The) — Lao Kip | LAK | 418 | 2 | | Lebanon — Lebanese Pound | LBP | 422 | 2 | | Lesotho — Loti | LSL | 426 | 2 | | Lesotho — Rand | ZAR | 710 | 2 | | Liberia — Liberian Dollar | LRD | 430 | 2 | | Libya — Libyan Dinar | LYD | 434 | 3 | | Liechtenstein — Swiss Franc | CHF | 756 | 2 | | Macao — Pataca | MOP | 446 | 2 | | Macedonia (The Former Yugoslav Republic Of) — Denar | MKD | 807 | 2 | | Madagascar — Malagasy Ariary | MGA | 969 | 2 | | Malawi — Malawi Kwacha | MWK | 454 | 2 | | Malaysia — Malaysian Ringgit | MYR | 458 | 2 | | Maldives — Rufiyaa | MVR | 462 | 2 | | Mali — CFA Franc BCEAO | XOF | 952 | 0 | | Mauritania — Ouguiya | MRU | 929 | 2 | | Mauritius — Mauritius Rupee | MUR | 480 | 2 | | Mexico — Mexican Peso | MXN | 484 | 2 | | Moldova (The Republic Of) — Moldovan Leu | MDL | 498 | 2 | | Mongolia — Tugrik | MNT | 496 | 2 | | Montserrat — East Caribbean Dollar | XCD | 951 | 2 | | Morocco — Moroccan Dirham | MAD | 504 | 2 | | Mozambique — Mozambique Metical | MZN | 943 | 2 | | Myanmar — Kyat | MMK | 104 | 2 | | Namibia — Namibia Dollar | NAD | 516 | 2 | | Namibia — Rand | ZAR | 710 | 2 | | Nauru — Australian Dollar | AUD | 036 | 2 | | Nepal — Nepalese Rupee | NPR | 524 | 2 | | New Caledonia — CFP Franc | XPF | 953 | 0 | | New Zealand — New Zealand Dollar | NZD | 554 | 2 | | Nicaragua — Cordoba Oro | NIO | 558 | 2 | | Niger (The) — CFA Franc BCEAO | XOF | 952 | 0 | | Nigeria — Naira | NGN | 566 | 2 | | Niue — New Zealand Dollar | NZD | 554 | 2 | | Norfolk Island — Australian Dollar | AUD | 036 | 2 | | Norway — Norwegian Krone | NOK | 578 | 2 | | Oman — Rial Omani | OMR | 512 | 3 | | Pakistan — Pakistan Rupee | PKR | 586 | 2 | | Panama — Balboa | PAB | 590 | 2 | | Papua New Guinea — Kina | PGK | 598 | 2 | | Paraguay — Guarani | PYG | 600 | 0 | | Peru — Sol | PEN | 604 | 2 | | Philippines (The) — Philippine Peso | PHP | 608 | 2 | | Pitcairn — New Zealand Dollar | NZD | 554 | 2 | | Poland — Zloty | PLN | 985 | 2 | | Qatar — Qatari Rial | QAR | 634 | 2 | | Romania — Romanian Leu | RON | 946 | 2 | | Russian Federation (The) — Russian Ruble | RUB | 643 | 2 | | Rwanda — Rwanda Franc | RWF | 646 | 0 | | Saint Helena, Ascension And Tristan Da Cunha — Saint Helena Pound | SHP | 654 | 2 | | Saint Kitts And Nevis — East Caribbean Dollar | XCD | 951 | 2 | | Saint Lucia — East Caribbean Dollar | XCD | 951 | 2 | | Saint Vincent And The Grenadines — East Caribbean Dollar | XCD | 951 | 2 | | Samoa — Tala | WST | 882 | 2 | | Sao Tome And Principe — Dobra | STN | 930 | 2 | | Saudi Arabia — Saudi Riyal | SAR | 682 | 2 | | Senegal — CFA Franc BCEAO | XOF | 952 | 0 | | Serbia — Serbian Dinar | RSD | 941 | 2 | | Seychelles — Seychelles Rupee | SCR | 690 | 2 | | Sierra Leone — Leone | SLL | 694 | 2 | | Sierra Leone — Leone | SLE | 925 | 2 | | Singapore — Singapore Dollar | SGD | 702 | 2 | | Sint Maarten (Dutch Part) — Netherlands Antillean Guilder | ANG | 532 | 2 | | Solomon Islands — Solomon Islands Dollar | SBD | 090 | 2 | | Somalia — Somali Shilling | SOS | 706 | 2 | | South Africa — Rand | ZAR | 710 | 2 | | South Sudan — South Sudanese Pound | SSP | 728 | 2 | | Sri Lanka — Sri Lanka Rupee | LKR | 144 | 2 | | Sudan (The) — Sudanese Pound | SDG | 938 | 2 | | Suriname — Surinam Dollar | SRD | 968 | 2 | | Svalbard And Jan Mayen — Norwegian Krone | NOK | 578 | 2 | | Eswatini — Lilangeni | SZL | 748 | 2 | | Sweden — Swedish Krona | SEK | 752 | 2 | | Switzerland — Swiss Franc | CHF | 756 | 2 | | Syrian Arab Republic — Syrian Pound | SYP | 760 | 2 | | Taiwan (Province Of China) — New Taiwan Dollar | TWD | 901 | 2 | | Tajikistan — Somoni | TJS | 972 | 2 | | Tanzania, United Republic Of — Tanzanian Shilling | TZS | 834 | 2 | | Thailand — Baht | THB | 764 | 2 | | Togo — CFA Franc BCEAO | XOF | 952 | 0 | | Tokelau — New Zealand Dollar | NZD | 554 | 2 | | Tonga — Pa’anga | TOP | 776 | 2 | | Trinidad And Tobago — Trinidad and Tobago Dollar | TTD | 780 | 2 | | Tunisia — Tunisian Dinar | TND | 788 | 3 | | Turkey — Turkish Lira | TRY | 949 | 2 | | Turkmenistan — Turkmenistan New Manat | TMT | 934 | 2 | | Tuvalu — Australian Dollar | AUD | 036 | 2 | | Uganda — Uganda Shilling | UGX | 800 | 0 | | Ukraine — Hryvnia | UAH | 980 | 2 | | United Arab Emirates (The) — UAE Dirham | AED | 784 | 2 | | United Kingdom Of Great Britain And Northern Ireland (The) — Pound Sterling | GBP | 826 | 2 | | Uruguay — Peso Uruguayo | UYU | 858 | 2 | | Uruguay — Unidad Previsional | UYW | 927 | 4 | | Uzbekistan — Uzbekistan Sum | UZS | 860 | 2 | | Vanuatu — Vatu | VUV | 548 | 0 | | Venezuela (Bolivarian Republic Of) — Bolívar Soberano | VES | 928 | 2 | | Viet Nam — Dong | VND | 704 | 0 | | Wallis And Futuna — CFP Franc | XPF | 953 | 0 | | Western Sahara — Moroccan Dirham | MAD | 504 | 2 | | Yemen — Yemeni Rial | YER | 886 | 2 | | Zambia — Zambian Kwacha | ZMW | 967 | 2 | | Zimbabwe — Zimbabwe Dollar | ZWL | 932 | 2 | | Zimbabwe — Zimbabwe Gold | ZWG | 924 | 2 |
## Other responses - `400`: The request was malformed. See the response body for details - `401`: Authentication information is missing or invalid - `403`: The authenticated client is forbidden to make the request for the resource identified. - `404`: The requested resource was not found - `412`: The conditions specified in the HTTP headers of the request were not met. - `429`: The number of requests (per minute) has exceeded the configured maximum --- [API](https://skmtc.dev/silverflow/apis/silverflow-api.md) - [All operations](https://skmtc.dev/silverflow/apis/silverflow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverflow/apis/silverflow-api/revisions/43ecbe4fd6ea?raw)