> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Materialien PayPal-Länderlisten

> Die vollständigen Listen der Bundesstaaten, Provinzen und Territorien für USA, Kanada und Mexiko zum Übernehmen in die CountryRule-Abschnitte der Zahlungsart PayPal.

Liefert ein Shop nach USA, Kanada oder Mexiko, erwartet PayPal zusätzlich zur Adresse den Bundesstaat beziehungsweise die Provinz. Diese Angabe holen Sie als Zusatzinformation zur Zahlungsart ab, in je einem Abschnitt `<+CountryRule>` pro Land. Jeder Eintrag der Auswahlliste ist ein Unterabschnitt `<+listentry>`.

Diese Seite enthält die drei vollständigen Listen zum Übernehmen. Wie Sie den Abschnitt drumherum aufbauen und was die einzelnen Parameter bedeuten, steht auf der Anleitungsseite und in der Referenz.

Wegweiser: [PayPal](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal.md) · [Zusatzinformationen zur Zahlungsart abfragen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md#zusatzinformationen-zur-zahlungsart-abfragen) · Referenz: [Abschnitt +CountryRule](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#countryrule)

## Der Rahmen um die Listen

Alle drei Listen stehen jeweils in einem eigenen `<+CountryRule>`-Abschnitt innerhalb des Abschnitts der Zahlungsart. Der Rahmen ist für alle drei Länder derselbe, nur `CountryList-ISO` und die Einträge wechseln.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentPaypal-Txt>
   <+CountryRule>
      ID                        = ws_clearing_paypal_state
      CountryList-ISO           = USA
      FieldDescr-Txt            = Bundesstaat
      Type                      = listbox
      Required                  = yes
      RequiredErrorMessage-Txt  = Bitte geben Sie den Bundesstaat der Lieferadresse an.
      HideInReadableOrder-Allow = yes
      <+listentry>
         ID        =
         Entry-Txt = Bitte wählen Sie
      </+listentry>
      <+listentry>
         ID        = AL
         Entry-Txt = Alabama
      </+listentry>
      ...
   </+CountryRule>
</PaymentPaypal-Txt>
```

Die Ländercodes für `CountryList-ISO` sind die dreistelligen Codes nach ISO 3166: `USA`, `CAN` und `MEX`.

Die Kennung unter `ID` hängt an der Anbindungsart, nicht am Land. Bei der Direktanbindung heißt sie `ws_clearing_paypal_state`, bei der Anbindung über Computop `ws_clearing_computop_paypal_state`. Für alle drei Länder ist es dieselbe Kennung, Sie legen also drei Abschnitte mit gleicher `ID` und unterschiedlichem `CountryList-ISO` an.

Bei beiden Kennungen setzt der Shop die Bezugsadresse von sich aus auf die Lieferadresse und fällt auf die Rechnungsadresse zurück, wenn keine Lieferadresse gewählt wurde. Was Sie bei `UseAddressInput` eintragen, spielt für diese beiden Kennungen keine Rolle.

> [!WARNING]
>
> Zum Zahlungsdienstleister geht ausschließlich der Wert aus `ID`, nicht der Text aus `Entry-Txt`. Die Kürzel in den Tabellen unten müssen deshalb genau so stehenbleiben. Die Beschriftungen dürfen Sie dagegen frei ändern, übersetzen oder ausschreiben, ohne dass sich an der Übergabe etwas ändert.

Der erste Eintrag mit leerer `ID` ist der Platzhalter "Bitte wählen Sie". Eine leere `ID` ist zulässig, ein leeres `Entry-Txt` dagegen nicht: Einträge ohne Beschriftung überspringt der Shop beim Einlesen stillschweigend. Zusammen mit `Required = yes` sorgt der Platzhalter dafür, dass eine fehlende Auswahl die Fehlermeldung auslöst.

Eine Auswahlliste eines `<+CountryRule>`-Abschnitts fasst höchstens 100 Einträge. Weitere Einträge liest der Shop nicht mehr ein. Die längste Liste hier hat mit den 52 Einträgen der USA und dem Platzhalter 53 Zeilen und bleibt deutlich darunter.

Vergessen Sie die allgemeine Fehlermeldung für fehlende Zusatzangaben nicht:

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   PaymentInputSuffix = Bitte ergänzen Sie die erforderlichen Angaben zu Ihrer gewählten Zahlungsart.
</NotifyMessages-Txt>
```

## USA

52 Einträge: die 50 Bundesstaaten, der Bundesdistrikt und Puerto Rico.

| ID | Entry-Txt |
| - | - |
| `AL` | Alabama |
| `AK` | Alaska |
| `AZ` | Arizona |
| `AR` | Arkansas |
| `CA` | California |
| `CO` | Colorado |
| `CT` | Connecticut |
| `DE` | Delaware |
| `DC` | District Of Columbia (Washington, D.C.) |
| `FL` | Florida |
| `GA` | Georgia |
| `HI` | Hawaii |
| `ID` | Idaho |
| `IL` | Illinois |
| `IN` | Indiana |
| `IA` | Iowa |
| `KS` | Kansas |
| `KY` | Kentucky |
| `LA` | Louisiana |
| `ME` | Maine |
| `MD` | Maryland |
| `MA` | Massachusetts |
| `MI` | Michigan |
| `MN` | Minnesota |
| `MS` | Mississippi |
| `MO` | Missouri |
| `MT` | Montana |
| `NE` | Nebraska |
| `NV` | Nevada |
| `NH` | New Hampshire |
| `NJ` | New Jersey |
| `NM` | New Mexico |
| `NY` | New York |
| `NC` | North Carolina |
| `ND` | North Dakota |
| `OH` | Ohio |
| `OK` | Oklahoma |
| `OR` | Oregon |
| `PA` | Pennsylvania |
| `PR` | Puerto Rico |
| `RI` | Rhode Island |
| `SC` | South Carolina |
| `SD` | South Dakota |
| `TN` | Tennessee |
| `TX` | Texas |
| `UT` | Utah |
| `VT` | Vermont |
| `VA` | Virginia |
| `WA` | Washington |
| `WV` | West Virginia |
| `WI` | Wisconsin |
| `WY` | Wyoming |

Die Liste ist nach dem Namen sortiert, nicht nach dem Kürzel. Deshalb steht `DC` zwischen Delaware und Florida und `PR` zwischen Pennsylvania und Rhode Island. Im Auswahlfeld erscheinen die Einträge in genau dieser Reihenfolge, der Shop sortiert nicht nach.

Weitere Außengebiete wie Guam oder die Amerikanischen Jungferninseln und die Kürzel der US-Militärpostadressen `AA`, `AE` und `AP` enthält die Liste nicht. Wenn Sie dorthin liefern, ergänzen Sie die betreffenden Einträge selbst.

## Kanada

13 Einträge: zehn Provinzen und drei Territorien.

| ID | Entry-Txt |
| - | - |
| `AB` | Alberta |
| `BC` | British Columbia |
| `MB` | Manitoba |
| `NB` | New Brunswick |
| `NL` | Newfoundland and Labrador |
| `NT` | Northwest Territories |
| `NS` | Nova Scotia |
| `NU` | Nunavut |
| `ON` | Ontario |
| `PE` | Prince Edward Island |
| `QC` | Quebec |
| `SK` | Saskatchewan |
| `YT` | Yukon |

Das Kürzel `NL` bleibt unverändert, denn nur dieses geht an PayPal.

## Mexiko

32 Einträge: 31 Bundesstaaten und der Bundesdistrikt.

| ID | Entry-Txt |
| - | - |
| `AG` | Aguascalientes |
| `BC` | Baja California Norte |
| `BS` | Baja California Sur |
| `CH` | Chihuahua |
| `CL` | Colima |
| `CM` | Campeche |
| `CO` | Coahuila |
| `CS` | Chiapas |
| `DF` | Distrito Federal |
| `DG` | Durango |
| `EM` | Mexico |
| `GR` | Guerrero |
| `GT` | Guanajuato |
| `HG` | Hidalgo |
| `JA` | Jalisco |
| `MI` | Michoacan |
| `MO` | Morelos |
| `NA` | Nayarit |
| `NL` | Nuevo Leon |
| `OA` | Oaxaca |
| `PU` | Puebla |
| `QR` | Quintana Roo |
| `QT` | Queretaro |
| `SI` | Sinaloa |
| `SL` | San Luis Potosi |
| `SO` | Sonora |
| `TB` | Tabasco |
| `TL` | Tlaxcala |
| `TM` | Tamaulipas |
| `VE` | Veracruz |
| `YU` | Yucatan |
| `ZA` | Zacatecas |

Diese Liste ist nach dem Kürzel sortiert, nicht nach dem Namen. Fällt Ihnen die Suche nach dem Namen leichter, sortieren Sie die Einträge um: Der Shop gibt sie in der Reihenfolge aus, in der sie in der Konfiguration stehen.

Zwei Beschriftungen sind veraltet: `DF` heißt seit 2016 "Ciudad de México", und `BC` heißt amtlich nur "Baja California" ohne "Norte". Beide Kürzel bleiben so, wie sie sind. Die Beschriftungen können Sie ändern, wenn Ihre Kunden die heutigen Namen erwarten.

## Auch für andere Zahlungsarten

Dieselbe Liste brauchen Sie bei der Kreditkartenzahlung über Computop. Mit 3-D Secure 2.0 verlangt auch diese den Bundesstaat der Lieferadresse, und zwar unter der Kennung `ws_clearing_computop_cc_state`. Der Aufbau des Abschnitts ist derselbe, nur die Kennung wechselt.

Wegweiser: [Kreditkarte](https://dokumentation.websale.de/v8s/referenz/tags/cc.md) · Referenz: Abschnitt +CountryRule


## Related topics

- [PayPal](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal.md)
- [PPC- (PayPal Checkout)](https://dokumentation.websale.de/v8s/referenz/tags/ppc-paypal-checkout.md)
- [Zahlungsarten-Codes](https://dokumentation.websale.de/v8s/materialien/zahlungsarten-codes.md)
- [PayPal PLUS](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal-plus.md)
- [PayPal Checkout](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal-checkout.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.