# Virtuelles Währungspaket erstellen

Erstellt ein virtuelles Währungspaket.

Endpoint: POST /v2/project/{project_id}/admin/items/virtual_currency/package
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/.
    Example: 44056

## Request fields (application/json):

  - `sku` (string, required)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

  - `name` (object,null, required)
    Objekt mit Lokalisierungen für Artikelnamen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `description` (object,null, required)
    Objekt mit Lokalisierungen für Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `long_description` (object,null)
    Objekt mit Lokalisierungen für lange Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Varianten angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `image_url` (string)
    Bild-URL. Damit das Bild im Zahlungsportal korrekt angezeigt und schnell geladen wird, beachten Sie bitte unsere Richtlinien für Bilder und URLs:Unterstützte Formate: WebP (empfohlen), PNG, JPG.Dateigröße: ≤ 50 kB (für WebP) oder ≤ 150 kB (für PNG und JPG).Bildgröße: 280 x 280 px.Farbraum: sRGB.Protokoll: HTTPS mit langlebigem Caching für versionierte URLs.

  - `media_list` (array)
    Zusätzliche Medieninhalte des Artikels wie Screenshots, Gameplay-Videos usw.

  - `media_list.type` (string)
    Medieninhaltstyp: image/video.
    Enum: "image", "video"

  - `media_list.url` (string)
    Ressourcendatei.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `groups` (array)
    Liste der [externen Gruppen-IDs](/de/api/catalog/item-groups-admin/admin-get-item-group-list/#!path=groups/external_id&t=response), zu denen der Artikel gehört.

Beispiel: ["horror", "action"]

  - `attributes` (array)
    Liste der Attribute.

Achtung: Sie können für den Artikel maximal 20 Attribute angeben. Jeder Versuch, das Limit zu überschreiten, führt zu einem Fehler.

  - `attributes.external_id` (string, required)
    Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten.

  - `attributes.name` (object)
    Objekt mit lokalisierten Attributnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

  - `attributes.values` (array, required)
    Achtung: Sie können für jedes Attribut maximal 6 Werte erstellen. Jeder Versuch, das Limit zu überschreiten, führt zu einem Fehler.
    Example: [{"external_id":"strategy","value":{"en":"Strategy","de":"Strategie"}},{"external_id":"action","value":{"en":"Action","de":"Aktion"}}]

  - `attributes.values.external_id` (string, required)
    Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.
    Example: "value_external_id"

  - `attributes.values.value` (object, required)
    Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

  - `prices` (array)
    Example: [{"currency":"USD","amount":10.5,"is_default":true,"is_enabled":true,"country_iso":"US"}]

  - `prices.currency` (string, required)
    Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu [Von Xsolla unterstützte Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `prices.amount` (number, required)
    Artikelpreis in echter Währung.
    Example: 10.5

  - `prices.is_default` (boolean)
    Ob es sich um den Standardpreis in realer Währung handelt. Ausführliche Informationen zu den Preiseinstellungen finden Sie in unserer [Dokumentation](https://developers.xsolla.com/de/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination).
    Example: true

  - `prices.is_enabled` (boolean)
    Ob dieser Preis für die Anzeige im Katalog und für den Kauf des Artikels verwendet wird. Falls false festgelegt ist, wird der Preis nicht verwendet und stattdessen ein anderer Preis angewendet. Ausführliche Informationen zu den Preiseinstellungen finden Sie in unserer [Dokumentation](https://developers.xsolla.com/de/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination).
    Example: true

  - `prices.country_iso` (string,null)
    Land, in dem dieser Preis gilt. Code bestehend aus zwei Buchstaben gemäß [ISO 3166-1 Alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `vc_prices` (array,null)
    Array der Preisangaben in virtueller Währung.
    Example: [{"sku":"com.xsolla.gold_1","amount":10,"is_default":true,"is_enabled":true}]

  - `vc_prices.sku` (string, required)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "com.xsolla.gold_1"

  - `vc_prices.amount` (integer, required)
    Artikelpreis in virtueller Währung.
    Example: 10

  - `vc_prices.is_default` (boolean, required)
    Ob es sich um den Standardpreis in virtueller Währung handelt.
    Example: true

  - `vc_prices.is_enabled` (boolean, required)
    Ob dieser Preis für die Anzeige im Katalog und für den Kauf des Artikels verwendet wird. Falls false festgelegt ist, wird der Preis nicht verwendet.
    Example: true

  - `is_enabled` (boolean)
    Ob der Artikel verfügbar ist. Falls false festgelegt ist, kann der Artikel weder im Shop erworben noch als Teil eines Bundles oder im Rahmen einer Marketingkampagne bezogen werden. Ausführliche Informationen zur Verfügbarkeit von Artikeln finden Sie in unserer [Dokumentation](https://developers.xsolla.com/de/items-catalog/catalog-features/items-availability/).

  - `is_show_in_store` (boolean)
    Ob der Artikel im Katalog angezeigt wird. Wenn false und is_enabled: true festgelegt ist, ist der Artikel im Katalog nicht sichtbar, kann jedoch als Teil eines Bundles oder im Rahmen von Marketingkampagnen bezogen werden. Ausführliche Informationen zur Verfügbarkeit von Artikeln finden Sie in unserer [Dokumentation](https://developers.xsolla.com/de/items-catalog/catalog-features/items-availability/).

  - `is_free` (boolean)
    Ob der Artikel kostenlos ist.

  - `is_paid_randomized_reward` (boolean)
    Ob der Artikel eine kostenpflichtige zufällige Belohnung ist, z. B. eine Lootbox.

  - `order` (integer)
    Reihenfolge, in der die Artikel im Katalog angezeigt werden. Je höher der Wert, desto weiter unten erscheint der Artikel in der Liste.
Bei gleichen Werten werden die Artikel nach Erstellungsdatum sortiert, wobei neuere Artikel weiter oben angezeigt werden.

  - `content` (array, required)
    Nur 1 Position des virtuellen Währungspakets sollte virtuelle Währung sein.

  - `content.sku` (string)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

  - `content.quantity` (integer)

  - `regions` (array)
    Array der Regionen, in denen der Artikel erhältlich ist. Ist das Array leer oder wird es nicht übermittelt, ist der Artikel in allen Regionen erhältlich.

  - `regions.id` (integer)
    Regions-ID innerhalb des Projekts.

Ausführliche Informationen finden Sie in der [Dokumentation zu den regionalen Verkaufsbeschränkungen](https://developers.xsolla.com/de/items-catalog/catalog-features/regional-restrictions/) sowie in den [API-Aufrufen zur Regionsverwaltung](https://developers.xsolla.com/de/api/catalog/common-regions).
    Example: 1

  - `limits` (object)
    Artikelbeschränkungen.

  - `limits.per_user` (any)
    Artikelbeschränkung für einen separaten Nutzer.

  - `limits.per_item` (integer,null)
    Globale Artikelbeschränkung.

  - `limits.recurrent_schedule` (object,null)
    Aktualisierungszeitraum begrenzen.

  - `limits.recurrent_schedule.per_user` (any)
    Das Kauflimit wird gemäß dem in Stunden angegebenen Zeitintervall zurückgesetzt.

  - `periods` (array,null)
    Artikelangebotszeitraum.

  - `periods.date_from` (string)
    Datum, an dem der angegebene Artikel zum Verkauf angeboten wird.
    Example: "2020-08-11T10:00:00+03:00"

  - `periods.date_until` (string,null)
    Datum, an dem der angegebene Artikel nicht mehr zum Verkauf angeboten wird. Möglich ist: null.
    Example: "2020-08-11T20:00:00+03:00"

  - `custom_attributes` (object)
    Ein JSON-Objekt mit den Artikelattributen und ‑werten. Attribute ermöglichen es Ihnen, Artikeln weitere Informationen hinzuzufügen, z. B. das Mindestlevel des Spielers, um den Artikel verwenden zu können. Attribute bereichern die interne Logik Ihres Spiels und sind über spezielle GET-Methoden und Webhooks abrufbar.

## Response 201 fields (application/json):

  - `sku` (string)
    Example: "com.xsolla.item_1"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

## Response 422 fields (application/json):

  - `statusCode` (integer)
    Example: 422

  - `errorCode` (integer)
    Example: 1102

  - `errorMessage` (string)
    Example: "[0401-1102]: Unprocessable Entity. The property `property_name` is required"

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"

  - `errorMessageExtended` (array)