Vous pouvez utiliser votre propre ID utilisateur lorsque vous vendez un panier contenant des jeux.
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.
Télécharger la description d'OpenAPI
Langues
Serveurs
Mock server
https://xsolla.redocly.app/_mock/fr/api/shop-builder/
https://store.xsolla.com/api/
Catalogue personnalisé
Cette API permet de spécifier des règles pour les attributs utilisateur. Si l'utilisateur remplit toutes les conditions d'une règle concrète, des objets personnalisés seront affichés.
Pour les promotions personnalisées, voir la section Promotions.
Pour passer des attributs avant un achat, utilisez Xsolla Login API ou passez-les dans la propriété user.attributes lors de la génération du jeton à l'aide de Pay Station API.
Opérations
Chemin
ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
Exemple: 44056
En-têtes
Corpsapplication/jsonL'identifiant de l'utilisateur peut être passé en utilisant le JWT utilisateur Xsolla Login ou le jeton d'accès Pay Station.
Exemple: ACCESS_TOKEN/LOGIN_JWT
Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Consultez la documentation pour obtenir des informations détaillées sur les pays pris en charge par Xsolla.
Exemple : country=US
Exemple: "US"
Devise du prix de l'objet affiché dans le panier. Code de devise à trois lettres selon ISO 4217. Consultez la documentation pour obtenir des informations détaillées sur les devises prises en charge par Xsolla.
Exemple: "USD"
- Mock serverhttps://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/admin/project/{project_id}/cart/fill
- https://store.xsolla.com/api/v2/admin/project/{project_id}/cart/fill
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
-u <username>:<password> \
'https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/admin/project/44056/cart/fill?locale=en' \
-H 'Content-Type: application/json' \
-H 'x-user-for: ACCESS_TOKEN/LOGIN_JWT' \
-H 'x-user-id: UNIQUE_ID' \
-d '{
"currency": "USD",
"items": [
{
"quantity": 2,
"sku": "com.xsolla.cup01"
},
{
"quantity": 1,
"sku": "com.xsolla.t-shirt01"
},
{
"quantity": 1,
"sku": "com.xsolla.cup01"
},
{
"quantity": 1,
"sku": "com.xsolla.hat01"
}
]
}'Le panier contenant des objets a été renvoyé avec succès.
ID de panier. Passez-le à la requête pour la page d'achat ou aux endpoints de l'API de paiement.
Exemple: "cart_id"
Si ce paramètre est défini sur true, le panier est gratuit.
Par défaut false
Exemple: false
Promotions appliquées à l'ensemble du panier. Le tableau est renvoyé dans les cas suivants :
Une promotion affecte le montant total du panier, comme un code promo avec le paramètre Discount on purchase.
Une promotion ajoute des objets bonus au panier.
Si aucune promotion de ce type n’est appliquée, un tableau vide est renvoyé.
Réponse
application/json
{ "cart_id": "cart_id", "is_free": false, "items": [ { … }, { … }, { … } ], "price": { "amount": "15.97", "amount_without_discount": "22.96", "currency": "USD" }, "promotions": [ { … } ], "warnings": [ { … } ] }
Chemin
ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
Exemple: 44056
En-têtes
Corpsapplication/jsonL'identifiant de l'utilisateur peut être passé en utilisant le JWT utilisateur Xsolla Login ou le jeton d'accès Pay Station.
Exemple: ACCESS_TOKEN/LOGIN_JWT
Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Consultez la documentation pour obtenir des informations détaillées sur les pays pris en charge par Xsolla.
Exemple : country=US
Exemple: "US"
Devise du prix de l'objet affiché dans le panier. Code de devise à trois lettres selon ISO 4217. Consultez la documentation pour obtenir des informations détaillées sur les devises prises en charge par Xsolla.
Exemple: "USD"
- Mock serverhttps://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/admin/project/{project_id}/cart/{cart_id}/fill
- https://store.xsolla.com/api/v2/admin/project/{project_id}/cart/{cart_id}/fill
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
-u <username>:<password> \
'https://xsolla.redocly.app/_mock/fr/api/shop-builder/v2/admin/project/44056/cart/custom_id/fill?locale=en' \
-H 'Content-Type: application/json' \
-H 'x-user-for: ACCESS_TOKEN/LOGIN_JWT' \
-H 'x-user-id: UNIQUE_ID' \
-d '{
"currency": "USD",
"items": [
{
"quantity": 2,
"sku": "com.xsolla.cup01"
},
{
"quantity": 1,
"sku": "com.xsolla.t-shirt01"
},
{
"quantity": 1,
"sku": "com.xsolla.cup01"
},
{
"quantity": 1,
"sku": "com.xsolla.hat01"
}
]
}'Le panier contenant des objets a été renvoyé avec succès.
ID de panier. Passez-le à la requête pour la page d'achat ou aux endpoints de l'API de paiement.
Exemple: "cart_id"
Si ce paramètre est défini sur true, le panier est gratuit.
Par défaut false
Exemple: false
Promotions appliquées à l'ensemble du panier. Le tableau est renvoyé dans les cas suivants :
Une promotion affecte le montant total du panier, comme un code promo avec le paramètre Discount on purchase.
Une promotion ajoute des objets bonus au panier.
Si aucune promotion de ce type n’est appliquée, un tableau vide est renvoyé.
Réponse
application/json
{ "cart_id": "cart_id", "is_free": false, "items": [ { … }, { … }, { … } ], "price": { "amount": "15.97", "amount_without_discount": "22.96", "currency": "USD" }, "promotions": [ { … } ], "warnings": [ { … } ] }