Benutzern gekaufte Artikel gewähren

Digital Distribution Hub API

In-Game Store & Buy Button API

Überblick

API-Definition herunterladen

BENUTZERATTRIBUTE

Administrator

Personalisierter Katalog

BUNDLES

Administrator

Katalog

WARENKORB UND ZAHLUNG

Warenkorb (clientseitig)

Warenkorb (serverseitig)

Zahlung (clientseitig)

Zahlung (serverseitig)

Bestellung

Kostenlose Artikel

ALLGEMEINES

Webhooks

Vorbestellungen

Händler

Katalog

Gängige Regionen

SPIELSCHLÜSSEL

Katalog

Berechtigung

Administrator

SPIELERINVENTAR

Client

Verwaltung

post

Benutzern gekaufte Artikel gewähren

post

Inventarartikel widerrufen

post

Benutzern Artikel gewähren

post

Artikel für Benutzer festlegen

Inventarübergreifend

WERBEAKTIONEN

Allgemeines

Gutscheine

Promocodes

Katalogsonderangebote

Rabatte

Prämien

VIRTUELLE GEGENSTÄNDE UND WÄHRUNG

Administrator

Katalog

Virtuelle Zahlung

NFT-ARTIKEL

Administrator

Katalog

LIMITS

Verwaltung

REWARD CHAINS & VALUE POINTS

Administrator

Client

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

Benutzern gekaufte Artikel gewähren

post/v2/project/{project_id}/inventory/purchase

Fügt die angegebenen, gekauften Artikel dem angegebenen Benutzerinventaren hinzu.

Achtung

Es können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

Projekt-ID.

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" Die eindeutige Benutzerkennung auf der Plattform.

required

Array of objects non-empty

Array (non-empty)

sku required	string Default: "booster_mega_1" Artikelklassenkennung. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.
quantity required	number Default: 1 Anzahl der Artikel dieser Klasse, die gewährt werden müssen.

required

object

amount required	string Default: "2.99" Kaufbetrag vor Abzügen.
currency required	string Default: "USD" Kaufwährung gemäß ISO 4217.
external_purchase_id required	string Default: "10-534-35" Rechnungskennung der Plattform, auf der der Kauf getätigt wurde.
external_purchase_date required	string Default: "2020-01-01T05:00:00+05:00" Kaufdatum gemäß ISO 8601.

comment

string [ 1 .. 255 ] characters

Default: "Monthly challenge rewards"

Vorgangsbeschreibung. Zum Beispiel: „Belohnungen für monatliche Herausforderung“.

object [ 1 .. 200 ] properties

Projektspezifische Parameter.

additional property	Array of arrays or object or string or integer or null or number or boolean
One of: arrays

platform

string

Default: "xsolla"

Publishing-Plattform, auf der der Benutzer spielt.

Enum: "playstation_network" "xbox_live" "xsolla" "pc_standalone" "nintendo_shop" "google_play" "app_store_ios" "android_standalone" "ios_standalone" "android_other" "ios_other" "pc_other"

Responses

200

Erfolgreicher Benutzerkauf.

422

Unverarbeitbare Entität.

Request samples

application/json

[{"purchase": {"amount": "3.5",
"comment": "xsolla",
"currency": "USD",
"custom_parameters": [{"user_device_info": {"engine_version": "Unity 2020.2.0b5",
"os": "windows"
},
"user_public_id": {"nickname": "player1"
}
},
{"comment": "xsolla",
"custom_parameters": {"content_creator_rewards": [{"content_creator": {"id": "cc1"
},
"reward": {"amount": "10.00",
"currency": "USD"
}
},
{"content_creator": {"id": "cc2"
},
"reward": {"amount": "15.00",
"currency": "RUB"
}
}
]
},
"items": [{"quantity": 5,
"sku": "panda_sdk3"
},
{"quantity": 3,
"sku": "panda_sdk2"
}
],
"platform": "xsolla",
"purchase": {"amount": "3.5",
"currency": "USD",
"external_purchase_date": "2020-01-01T00:00:00+05:00",
"external_purchase_id": "1000001"
},
"user": {"id": "83857636-65b4-11e8-9ccb-42010a8a001c"
}
}
],
"external_purchase_date": "2020-01-01T00:00:00+05:00",
"external_purchase_id": "1000000",
"items": [{"quantity": 5,
"sku": "panda_sdk"
},
{"quantity": 3,
"sku": "panda_sdk2"
}
],
"platform": "xsolla",
"user": {"id": "672c91cd-65db-4b6e-ad68-6e93b21249d8"
}
}
}
]

Response samples

application/json

{"count": 2,
"operations": [{"amount": "2.99",
"comment": "Quest completed",
"currency": "USD",
"custom_parameters": {"array_param": [{"user_device_info": {"engine_version": "Unity 2020.2.0b5",
"os": "windows"
},
"user_public_id": {"nickname": "player1"
}
},
{"user_device_info": {"engine_version": "UE 4.25",
"os": "mac"
},
"user_public_id": {"nickname": "player2"
}
}
]
},
"external_purchase_date": "2020-01-01T05:00:00+05:00",
"external_purchase_id": "10-534-35",
"items": [{"quantity": 5,
"sku": "boots_1"
},
{"quantity": 3,
"sku": "crystal_pack_1"
}
],
"order_id": 123456,
"platform": "xbox_live",
"user_id": "0125760a-6810-11e9-84c0-42010aa80029"
},
{"amount": "2.99",
"comment": "Daily reward",
"currency": "USD",
"custom_parameters": null,
"external_purchase_date": "2020-01-01T05:00:00+05:00",
"external_purchase_id": "10-534-35",
"items": [{"quantity": 2,
"sku": "helmet_1"
},
{"quantity": 3,
"sku": "minigun_1"
}
],
"order_id": 123457,
"platform": "xbox_live",
"user_id": "a7d10a4e-3f68-43cc-a6b2-893d2c68fd14"
}
]
}