Passer au contenu
/
Lire une commande

Digital Distribution Hub (1.0.0)

Aperçu

Digital Distribution Hub est une nouvelle solution Xsolla qui comble le fossé entre les paiements numériques et les paiements en espèces via la technologie des paiements push et le e-commerce.

Cette référence décrit les endpoints API de deux produits Xsolla : In-Game Store et Pay Station. Deux URL de base sont utilisées :

  • https://store.xsolla.com/api pour les groupes Communs, Catalogue, Panier, et Commande.
  • https://ps.xsolla.com pour le groupe Notifications.

Les endpoints API dans le groupe Catalogue ne requièrent pas d'autorisation.

Pour utiliser les opérations des groupes Panier et Commande, vous devez générer un jeton via Create user token.

Note

Cette référence présente un projet d'une future API et non une interface entièrement fonctionnelle. Actuellement, vous ne pouvez essayer que les endpoints des groupes Catalogue et Notifications. Si vous souhaitez nous faire part de vos commentaires, envoyez-nous un e-mail à l'adresse suivante : techdoc@xsolla.com.
Télécharger la description d'OpenAPI
index.json
index.yaml
Langues
Serveurs
Mock server
https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/
https://store.xsolla.com/api/

Panier

Opérations

Clés de jeu

Opérations

Objets et monnaie virtuels

Opérations

Lots

Opérations

Jeton d'utilisateur

Opérations

Notifications

Opérations

Commande

Opérations

Lire une commande

Requête

Récupère des informations sur une commande spécifique.

Sécurité
AuthForClient
Chemin
project_idintegerobligatoire

ID de projet.

Exemple: 44056
order_idstringobligatoire

ID de commande.

Exemple: 656
curl -i -X GET \
  https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/v2/project/44056/distribution_hub/order/656 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Réponses

Requête de commande acceptée.

Corpsapplication/json
contentobject(Order_inline_response_200_1_content)

Détails de la commande.

order_idinteger

ID de commande.

Exemple: 1
statusstring

Statut de la commande : new/paid/done/canceled.

Exemple: "paid"
Réponse
application/json
{
  "content": {
    "is_free": "false",
    "items": [ … ],
    "price": { … }
  },
  "order_id": 1,
  "status": "paid"
}

Créer une commande à partir de tous les objets du panier actuel

Requête

Crée une commande à partir de tous les objets d'un panier. La commande créée aura le statut new.

Sécurité
AuthForClient
Chemin
project_idintegerobligatoire

ID de projet.

Exemple: 44056
Corpsapplication/jsonobligatoire

Données pour la création de la commande.

currencystring(Cart-Payment_settings_currency)obligatoire

Devise de paiement préférée. Code de devise à trois lettres selon la norme ISO 4217.

geotypenumberobligatoire

ID du partenaire distributeur du côté de Xsolla.

Exemple: 13038
quantityinteger

Quantité de l'objet.

Exemple: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

Réponses

La commande a été créée avec succès.

Corpsapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

Informations sur la facturation.

order_idinteger

ID de commande.

Réponse
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}

Créer une commande à partir de tous les objets d'un panier spécifique

Requête

Crée une commande à partir de tous les objets d'un panier spécifique. La commande créée aura le statut new.

Sécurité
AuthForClient
Chemin
project_idintegerobligatoire

ID de projet.

Exemple: 44056
cart_idstringobligatoire

ID de panier.

Exemple: custom_id
Corpsapplication/jsonobligatoire

Données pour la création de la commande.

currencystring(Cart-Payment_settings_currency)obligatoire

Devise de paiement préférée. Code de devise à trois lettres selon la norme ISO 4217.

geotypenumberobligatoire

ID du partenaire distributeur du côté de Xsolla.

Exemple: 13038
quantityinteger

Quantité de l'objet.

Exemple: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart/custom_id \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

Réponses

La commande a été créée avec succès.

Corpsapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

Informations sur la facturation.

order_idinteger

ID de commande.

Réponse
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}