Ruft die Angebotskette des aktuellen Nutzers anhand der Angebotsketten-ID ab.
- Kostenlosen Angebotskettenschritt sichern
Shop Builder API (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc.
Personalisierter Katalog
Diese API ermöglicht es, Regeln für Benutzerattribute festzulegen. Wenn der Nutzer alle Bedingungen einer konkreten Regel erfüllt, werden personalisierte Artikel angezeigt.
Für personalisierte Werbeaktionen siehe Abschnitt Werbeaktionen.
Um Attribute vor einem Kauf zu übermitteln, können Sie die Xsolla Login API verwenden oder die Attribute in der Eigenschaft user.attributes übermitteln, während Sie den Token mit der Pay Station API generieren.
Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
- Mock serverhttps://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/{project_id}/user/offer_chain/{offer_chain_id}
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain/{offer_chain_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/user/offer_chain/101 \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Die Angebotskette des Nutzers wurde erfolgreich abgerufen.
Datum, an dem die Angebotskette endet. Kann null sein. Wenn für date_end der Wert null festgelegt ist, ist die Angebotskette zeitlich unbegrenzt.
Datum, an dem die Angebotskette beginnt.
Nächste Angebotskettenschritt-Nummer. null, wenn die Angebotskette abgeschlossen ist.
Reset-Zeitraum der Angebotskette.
{ "date_end": "2025-04-25T18:16:00+05:00", "date_start": "2010-04-15T18:16:00+05:00", "description": null, "id": 4, "name": "Offer chain with bundles", "next_step_number": 1, "order": 1, "recurrent_schedule": null, "steps": [ { … }, { … } ] }
Anfrage
Schließt den aktuellen Fortschritt des Nutzers in der Angebotskette ab und gewährt die zugehörige Belohnung.
Verwenden Sie diesen Aufruf nur bei kostenlosen Schritten in der Angebotskette. Bei Schritten, die eine Zahlung in echter Währung erfordern, müssen Sie stattdessen den Aufruf Bestellung für kostenpflichtigen Angebotskettenschritt anlegen verwenden.
Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
- Mock serverhttps://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/user/offer_chain/101/step/number/1/claim \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'{ "order_id": 641 }
Anfrage
Legt eine Bestellung für den Artikel an, der mit dem angegebenen kostenpflichtigen Angebotskettenschritt verknüpft ist. Der angelegten Bestellung wird der Status new zugewiesen.
Öffnen Sie das Zahlungsportal in einem neuen Fenster mithilfe des folgenden Links: https://secure.xsolla.com/paystation4/?token={token}, wobei {token} der erhaltene Token ist.
Für Testzwecke steht Ihnen die folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation4/?token={token}.
Diese Methode muss clientseitig verwendet werden. Anhand der IP-Adresse des Nutzers wird das Land ermittelt und davon wiederum die Währung und die verfügbaren Zahlungsmethoden abgeleitet. Wird diese Methode serverseitig verwendet, wird mögliccherweise eine falsche Währung ermittelt, was sich wiederum auf die Zahlungsmethoden in Pay Station auswirkt.
Verwenden Sie diesen Aufruf nur bei kostenpflichtigen Schritten in der Angebotskette. Bei kostenlosen Schritten müssen Sie stattdessen den Aufruf Kostenlosen Angebotskettenschritt sichern verwenden.
Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
- Mock serverhttps://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order
- https://store.xsolla.com/api/v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/user/offer_chain/101/step/number/1/order \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'{ "order_id": 641, "token": "f4puMEFFDZcx9nv5HoNHIkPe9qghvBQo" }