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.
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 :
- Paiement (
payment) et Remboursement (refund) avec des informations sur les données de paiement et de transaction. - Paiement de commande réussi (
order_paid) et Annulation de commande (order_canceled) avec des informations sur les biens achetés.
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 à csm@xsolla.com.
Pour gérer pleinement le magasin en jeu et les paiements, il est nécessaire d’implémenter le traitement des principaux webhooks :
| Nom du webhook | Description |
|---|---|
User validation > Validation utilisateur (user_validation) | Est envoyé à différentes étapes du paiement pour s’assurer que l’utilisateur est bel et bien enregistré dans le jeu. |
Game services > Combined webhooks > Paiement de commande réussi (order_paid) | Il contient les données de paiement, les données de la transaction et des informations sur les objets achetés. Utilisez les données du webhook pour attribuer les objets à l’utilisateur. |
Game services > Combined webhooks > Annulation de commande (order_canceled) | Il contient les données du paiement annulé, les données de la transaction et des informations sur les objets achetés. Utilisez les données du webhook pour retirer les objets achetés. |
Le schéma ci-dessous illustre le processus d’achat et de retour d’objets en utilisant les webhooks combinés.
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.
- Paiement,Paiement de commande réussi et Validation utilisateur si vous recevez des webhooks distincts ;
- Paiement de commande réussi et Validation utilisateur si vous recevez des webhooks combinés.
Configurer les webhooks dans le Compte éditeur
- Ouvrez le projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Paramètres du projet et accédez à l'onglet Webhooks.
- 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. - 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.
- Cliquez sur Activer les webhooks.
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.
| Nom de l’onglet pour le test du webhook | Nom et type de webhook |
|---|---|
| Payments and Store | User validation > Validation utilisateur (user_validation) |
Game services > Combined webhooks > Paiement de commande réussi (order_paid) | |
Game services > Combined webhooks > Annulation de commande (order_canceled) | |
| Subscriptions | User validation > Validation utilisateur (user_validation) |
Payments > Paiement (payment) |
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,201ou204en cas de réponse positive ; - Un code HTTP
400avec 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.
Étapes suivantes
Liens utiles
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.
