# Gängige Regionen
Mithilfe regionaler Verkaufsbeschränkungen können Sie die Verfügbarkeit von Artikeln in bestimmten Ländern oder Ländergruppen steuern. So können Sie beispielsweise ein Spiel aufgrund von Lizenzbeschränkungen nur in bestimmten Ländern verkaufen.
Die Beschränkungen werden über Regionen definiert. Jede Region fasst ein oder mehrere Länder unter einer einzigen Kennung (`region_id`) zusammen. Sie können einen Artikel einer oder mehreren Regionen zuordnen.
Die Verfügbarkeit eines Artikels wird wie folgt bestimmt:
* Wenn für einen Artikel keine Regionen angegeben sind, ist der Artikel in allen Ländern erhältlich.
* Wenn für einen Artikel Regionen angegeben sind und das Land des Nutzers zu einer dieser Regionen gehört, ist der Artikel für diesen Nutzer verfügbar.
* Wenn für einen Artikel Regionen angegeben sind und das Land des Nutzers zu keiner dieser Regionen gehört, ist der Artikel für diesen Nutzer nicht verfügbar.
Das Land des Nutzers wird im Parameter `country` übermittelt, wenn der Katalog über API-Aufrufe aus dem Unterbereich **Katalog** angefordert wird. Wird der Parameter nicht übermittelt, wird das Land anhand der IP-Adresse des Nutzers ermittelt.
Das Land des Nutzers wird zweimal mit den Regionen des Artikels abgeglichen: beim Anfordern des Katalogs und beim Anlegen einer Bestellung. Nicht verfügbare Artikel werden nicht in die Katalogantwort aufgenommen, und eine Bestellung mit einem solchen Artikel wird nicht angelegt.
Mit API-Aufrufen aus dem Unterabschnitt **Gängige Regionen** können Sie Regionen erstellen, aktualisieren und löschen.
Einrichtung regionaler Verkaufsbeschränkungen (Ablauf):
1. Erstellen Sie eine Region mithilfe des API-Aufrufs [Region erstellen](https://developers.xsolla.com/de/api/catalog/common-regions/admin-create-region/), geben Sie dabei die Liste der Länder an. In der Antwort ist eine `region_id` enthalten, die im nächsten Schritt benötigt wird.
2. Verknüpfen Sie einen virtuellen Gegenstand mit der Region, indem Sie beim [Erstellen](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-item/) oder [Aktualisieren](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-update-virtual-item/) des Artikels die `region_id` im `regions`-Array übermitteln.
3. Zeigen Sie dem Nutzer den Katalog mithilfe von API-Aufrufen aus dem Unterabschnitt **Katalog** an, beispielsweise mit dem API-Aufruf [Liste virtueller Gegenstände abrufen](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-virtual-items). Das Land des Nutzers wird anhand des Parameters `country` ermittelt oder, falls dieser nicht angegeben ist, anhand der IP-Adresse des Nutzers. Artikel, die im Land des Nutzers nicht verfügbar sind, fehlen in der Katalogantwort.
4. Wenn der Nutzer zur Bezahlung eines Artikels oder des Warenkorbs übergeht, muss eine Bestellung angelegt werden:
* Wenn der Artikel in den Warenkorb gelegt wurde muss die Bestellung mithilfe des API-Aufrufs [Bestellung mit allen Artikeln aus einem angegebenen Warenkorb anlegen](https://developers.xsolla.com/de/api/catalog/payment-client-side/create-order) oder [Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen](https://developers.xsolla.com/de/api/catalog/payment-client-side/create-order) angelegt werden.
* Beim Schnellkauf eines einzelnen Artikels muss die Bestellung mithilfe des API-Aufrufs [Bestellung mit angegebenem Artikel anlegen](https://developers.xsolla.com/de/api/catalog/payment-client-side/create-order-with-item) (unter Angabe der Artikel-SKU) angelegt werden.
In der Antwort ist ein Token zum Öffnen des Zahlungsportals enthalten.
Hinweis
Xsolla prüft, ob das Land des Nutzers in der für den Artikel festgelegten Region enthalten ist. Ist das Land nicht in der Region enthalten, kann die Bestellung nicht angelegt werden.
5. Implementieren Sie das Öffnen des Zahlungsportals, damit die Bestellung bezahlt werden kann.
