Regionale Verkaufsbeschränkungen

So funktioniert's

Mit regionalen Verkaufsbeschränkungen können Sie steuern, in welchen Ländern Artikel verkauft werden dürfen, und Missbrauch verhindern – beispielsweise wenn ein Nutzer einen Spielschlüssel in einer Region zu einem niedrigeren Preis erwirbt und ihn in einer anderen Region aktiviert.

Das Land des Nutzers wird im Parameter country übermittelt, wenn Sie einen Katalog mit den API-Aufrufen aus dem Unterabschnitt Katalog der Methodengruppe Spielschlüssel oder Virtuelle Gegenstände und Währung anfordern. Wenn der Parameter nicht angegeben ist, wird das Land anhand der IP-Adresse des Nutzers ermittelt. Das System erstellt daraufhin einen Katalog mit Artikeln, die im Land des Nutzers verfügbar sind.

Für wen ist es

Partner, die die Verfügbarkeit von Artikeln in bestimmten Ländern oder Regionen einschränken möchten.

Integrationsablauf

Hinweis
Wenn für einen Artikel Regionen angegeben sind und das Land des Nutzers kein Teil dieser Regionen ist, ist der Artikel in diesem Land nicht verfügbar.
So richten Sie regionale Verkaufsbeschränkungen ein:
  1. Erstellen Sie Regionen, in denen Artikel verfügbar sein sollen. Rufen Sie dazu den API-Aufruf Region erstellen auf. Die API gibt die Regions-ID zurück, die Sie im nächsten Schritt benötigen.
Erstellung einer Region “Nordamerika”, die die USA und Kanada umfasst (Beispiel):
Copy
Full screen
Small screen
1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}
Hinweis
Der Ländercode ist im Format ISO 3166-1 Alpha-2 angegeben. Werfen Sie einen Blick auf die Liste der von Xsolla unterstützten Länder, bevor Sie eine Region erstellen.
  1. Übermitteln Sie beim Erstellen oder Aktualisieren eines Artikels die Regions-ID an das Array regions mithilfe der entsprechenden API-Aufrufe aus dem Unterabschnitt Verwaltung:
Ein Array regions samt IDs der Regionen, in denen die Artikel verkauft werden können (Beispiel):
Copy
Full screen
Small screen
1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]
Achtung
Nachdem die Regionen konfiguriert und einem Spiel zugewiesen wurden, können Schlüssel nur noch über den API-Aufruf Codes hochladen hochgeladen werden.
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 13. Februar 2026

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!
Ihr Feedback konnte nicht gesendet werden
Versuchen Sie es später erneut oder kontaktieren Sie uns unter doc_feedback@xsolla.com.