Regionale Verkaufsbeschränkungen

So funktioniert's

Mit regionalen Verkaufsbeschränkungen können Sie steuern, in welchen Ländern Ihre virtuellen Gegenstände oder Währungspakete verkauft werden dürfen. Xsolla ermittelt das Land des Nutzers und zeigt nur die in dieser Region verfügbaren Artikel an.

Das Land des Nutzers wird im Parameter country übermittelt, wenn ein Katalog abgerufen wird (API-Aufruf Liste virtueller Gegenstände abrufen). Wenn das Land nicht explizit angegeben ist, wird es anhand der IP-Adresse des Nutzers ermittelt. Der Katalog wird dann auf Grundlage des Landes des Nutzers generiert.

Für wen ist es

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

Integrationsablauf

So legen Sie regionale Beschränkungen fest:

1. Erstellen Sie Regionen, in denen Ihrer Artikel verfügbar sein sollen, indem Sie die API Region erstellen aufrufen. Die API antwortet mit der Regions-ID, die Sie im nächten Schritt benötigen.

1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}

2. Übermitteln Sie die ID der Region an das regions-Array, wenn Sie die SKU eines Artikels erstellen oder aktualisieren. Rufen Sie dazu die entsprechende API-Methode aus der Kategorie Verwaltung der Gruppe Virtuelle Gegenstände und Währung auf.

1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]