Octroyer les achats à l’utilisateur

Implémentez l’octroi des achats à l’utilisateur dans votre application en utilisant les informations fournies par les webhooks de Xsolla concernant les détails de la transaction et les objets achetés.

Note

Côté Xsolla, deux options de réception de webhook ont été configurées lors de l’achat et du retour d’objets : les informations de paiement et de transaction, ainsi que celles des objets achetés, peuvent être envoyées séparément ou combinées en un seul webhook.

Plus d’informations sur les options de réception des webhooks

Réception d’informations dans des webhooks combinés :

Si vous avez enregistré votre Compte éditeur après le 22 janvier 2025, vous recevez toutes les informations dans les webhooks Paiement de commande réussi (order_paid) et Annulation de commande (order_canceled). Dans ce cas, vous n’avez pas besoin de traiter les webhooks Paiement (payment) et Remboursement (refund).

Réception d’informations dans des webhooks séparés :

Si vous avez enregistré votre Compte éditeur au plus tard le 22 janvier 2025, vous recevez les webhooks suivants :

Vous devez traiter tous les webhooks entrants.

Pour passer à la nouvelle option avec réception de webhooks combinés, contactez vos responsables de la réussite client ou envoyez un e-mail à [email protected].

Pour gérer pleinement le magasin en jeu et les paiements, il est nécessaire d’implémenter le traitement des principaux webhooks :

Si la personnalisation du catalogue des objets est implémentée côté application, implémentez le traitement de Personnalisation du catalogue côté partenaire.

Note
Pour recevoir des paiements réels, vous devez simplement signer le contrat de licence et implémenter le traitement des webhooks :

Configurer les webhooks dans le Compte éditeur

  1. Ouvrez le projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Paramètres du projet et accédez à l'onglet Webhooks.
  3. Dans le champ Serveur webhook, spécifiez l'URL du serveur où vous souhaitez recevoir les webhooks, dans le format https://example.com. Vous pouvez également spécifier l'URL que vous trouvez dans un outil de test de webhooks.
  4. Une clé secrète pour signer les webhooks du projet est générée par défaut. Si vous souhaitez générer une nouvelle clé secrète, cliquez sur l'icône d'actualisation.
  5. Cliquez sur Activer les webhooks.
Avis
Le protocole HTTPS est utilisé pour transférer les données ; le protocole HTTP n’est pas pris en charge.

Tester les webhooks dans le Compte éditeur

Si les webhooks sont configurés avec succès, un bloc de test de webhooks s’affiche sous le bloc de configuration des webhooks.

La section de test dans le Compte éditeur varie en fonction de l’option de réception du webhook.

En l’absence de valeurs réelles, saisissez des valeurs arbitraires.

Vous pouvez également tester les webhooks lorsque vous effectuez des achats en mode bac à sable ou en mode de production. Le test du webhook Refund n’est possible qu’en mode de production.

Envoi de réponses au webhook

Pour confirmer la réception du webhook, votre serveur doit renvoyer :

  • Un code HTTP 200, 201 ou 204 en cas de réponse positive ;
  • Un code HTTP 400 avec description du problème au cas où l’utilisateur spécifié n’a pas été trouvé ou une signature non valide a été passée.

Votre gestionnaire de webhooks peut également renvoyer un code 5xx en cas de problèmes temporaires sur votre serveur.

Note
La liste complète et le mécanisme des webhooks, ainsi que des exemples détaillés de leur traitement, sont décrits dans la documentation webhooks.

Étapes suivantes

  1. Implémentez l'obtention des informations d'abonnement.
  2. Configurez l'authentification utilisateur.

Configuration des informations sur les objets dans les webhooks

Vous pouvez configurer les données relatives aux objets inclus dans les webhooks Paiement de commande réussi et Annulation de commande via le tableau items.

Activation de l'inclusion de paramètres supplémentaires

Permet d’inclure des paramètres supplémentaires indiquant :

  • si l’objet est gratuit (is_free ) ;
  • si l’objet est un bonus (is_bonus) ;
  • si l’objet fait partie d’un lot (is_bundle_content).

Pour recevoir ces paramètres, vous devez mettre à jour vos webhooks vers la version 2 en utilisant l’appel API Mettre à jour les informations sur les paramètres du webhook. Dans la version 1 (par défaut), ces paramètres ne sont pas disponibles.

Exemple de tableau items avec des paramètres supplémentaires :

Copy
Full screen
Small screen
 1
 2"items": [
 3      {
 4        "sku": "com.xsolla.item_new_1",
 5        "type": "bundle",
 6        "is_pre_order": false,
 7        "is_free": false,
 8        "is_bonus": false,
 9        "Is_bundle_content": false,
10        "quantity": 1,
11        "amount": "1000",
12        "promotions": []
13      },
14      {
15        "sku": "com.xsolla.gold_1",
16        "type": "virtual_currency",
17        "is_pre_order": false,
18        "is_free": false,
19        "is_bonus": false,
20        "is_bundle_content": true,
21        "quantity": 1500,
22        "amount": "[null]",
23        "promotions": []
24      }
25 ],

Désactivation de l'inclusion du contenu du lot

Par défaut, les webhooks incluent tous les objets du lot sous forme de liste d’objets individuels. Vous pouvez configurer le webhook pour n’inclure que le lot lui-même, sans énumérer son contenu.

Dans ce cas, les objets contenus dans le lot ne sont pas inclus dans le tableau items. Par exemple, dans le tableau ci-dessus, l’objet portant l’UGS com.xsolla.gold_1, qui fait partie du lot, est exclu.

Exemple de tableau items lorsque le contenu du lot est désactivé :

Copy
Full screen
Small screen
 1
 2"items": [
 3      {
 4        "sku": "com.xsolla.item_new_1",
 5        "type": "bundle",
 6        "is_pre_order": false,
 7        "is_free": false,
 8        "is_bonus": false,
 9        "Is_bundle_content": false,
10        "quantity": 1,
11        "amount": "1000",
12        "promotions": []
13      }
14 ],

Pour désactiver l’inclusion du contenu des lots, contactez votre responsable de la réussite client ou envoyez un e-mail à [email protected].

Flux d’intégration

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 3 Juin 2025

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !
Impossible d'envoyer votre commentaire
Réessayez plus tard ou contactez-nous à [email protected].
OSZAR »