# Remboursement

Lorsqu'un paiement est annulé, Xsolla envoie les informations de la transaction 
annulée dans un webhook de type refund à l'URL du webhook.

Le mécanisme de réessai du webhook dépend de la personne qui a initié le 
remboursement :
* Si vous initiez le remboursement de votre côté, aucun webhook n'est envoyé. Le 
  paiement est remboursé à l'utilisateur indépendamment de la réponse au webhook.
* Si une tierce partie initie le remboursement, par exemple un système de 
  paiement ou l'équipe d'assistance Xsolla, et qu'un code d'état 5xx est 
  renvoyé en réponse au webhook, Xsolla renvoie ce webhook à des intervalles 
  croissants. Le nombre maximal de tentatives est de 12 dans les 48 heures 
  suivant la première tentative.

Pour obtenir des informations détaillées sur la procédure de remboursement, 
référez-vous aux instructions instructions.


Remarque
Le paiement sera quand même remboursé à l'utilisateur si toutes les conditions suivantes sont réunies :Xsolla a initié le remboursement.En réponse au webhook, un code d'état 4xx est renvoyé, ou aucune réponse n'est reçue après toutes les tentatives, ou un code d'état 5xx est renvoyé.


Lorsque vous enregistrez l'URL du webhook dans le Compte 
éditeur, vous pouvez également configurer la réception d'informations 
supplémentaires dans les webhooks.


Note
Si vous avez créé un Compte éditeur le 22 janvier 2025 ou avant, les bascules se trouvent dans le projet, sous la section Settings > Webhooks > Testing > Payments > Advanced settings.




    
        Bascule
        Description
    


    
        Afficher infos sur transactions effectuées via modes de paiement enregistrés
        Les informations sont passées dans les paramètres personnalisés suivants du webhook :saved_payment_method:0 — le mode de paiement enregistré n'a pas été utilisé ;1 — le mode de paiement a été enregistré lors du paiement en cours ;2 — le mode de paiement précédemment enregistré est utilisé.payment_type:1 — paiement unique ;2 — paiement récurrent.
    



Codes de remboursement :


    
    
        Code
        Motif
        Description
    
    
    
    
        1
        Cancellation by the user request / the game request
        Annulation initiée dans le Compte éditeur.
    
    
        2
        Chargeback
        Chargeback pour une transaction demandé.
    
    
        3
        Integration error
        Problèmes d'intégration entre Xsolla et le jeu.Recommandation : n'ajoutez pas l'utilisateur à la liste noire.
    
    
        4
        Potential fraud
        Fraude soupçonnée.Recommandation : ajoutez l'utilisateur à la liste noire.
    
    
        5
        Test payment
        Transaction test suivie d'une annulation.Recommandation : n'ajoutez pas l'utilisateur à la liste de noire.
    
    
        6
        User invoice expired
        Facture en retard (utilisée pour le modèle de paiement différé).
    
    
        7
        Fraud notification from PS
        Paiement refusé par le système de paiement en raison d'une fraude potentielle.Recommandation : ajoutez l'utilisateur à la liste noire.
    
    
        8
        Cancellation by the PS request
        Annulation demandée par le système de paiement.Recommandation : n'ajoutez pas l'utilisateur à la liste noire.
    
    
        9
        Cancellation by the user request
        Utilisateur non satisfait du jeu ou de l'achat pour quelque raison que ce soit.Recommandation : n'ajoutez pas l'utilisateur à la liste noire.
    
    
        10
        Cancellation by the game request
        Annulation demandée par le jeu.Recommandation : n'ajoutez pas l'utilisateur à la liste noire.
    
    
        11
        Account holder called to report fraud
        Le titulaire de compte déclare qu'il n'a pas effectué la transaction.
    
    
        12
        Friendly fraud
        Fraude de type « Friendly fraud » signalée.
    
    
        13
        Duplicate
        Transaction dupliquée pour la même facture.

Endpoint: POST refund
Version: 1.0

## Request fields (application/json):

  - `custom_parameters` (object)
    Vos paramètres personnalisés.

  - `notification_type` (string, required)
    Type de notification.

  - `payment_details` (object, required)
    Informations sur le paiement (objet).

  - `payment_details.country_wht` (object)
    Retenue à la source appliquée dans certains pays pour les transactions transfrontalières (objet).

  - `payment_details.country_wht.amount` (number)
    Montant.

  - `payment_details.country_wht.currency` (string)
    Devise. Code de devise à trois lettres selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.country_wht.percent` (number)
    Taux de retenue à la source du pays, en %.

  - `payment_details.direct_wht` (object)
    Retenue à la source directe.

  - `payment_details.direct_wht.percent` (number)
    Taux de retenue à la source directe.

  - `payment_details.payment` (object)
    Montant payé par l'utilisateur (objet).

  - `payment_details.payment_method_fee` (object)
    Frais du système de paiement.

  - `payment_details.payment_method_sum` (object)
    Montant débité du système de paiement.

  - `payment_details.payout` (object)
    Détails de virement (objet).

  - `payment_details.payout_currency_rate` (string)
    Taux de change entre les devises de paiement et de virement.

  - `payment_details.repatriation_commission` (object)
    Données sur les frais de rapatriement imposés à Xsolla par des tiers.

  - `payment_details.sales_tax` (object)
    Taxe de vente (objet ; États-Unis et Canada uniquement).

  - `payment_details.sales_tax.percent` (number)
    Taux de taxe de vente.

  - `payment_details.user_acquisition_fee` (object)
    Montant total de la commission d'acquisition d'utilisateurs déduits pour les achats effectués via les réseaux d'affiliation et les influenceurs (objet).

  - `payment_details.user_acquisition_fee.percent` (number)
    Taux de la commission d'acquisition de l'utilisateur, en %.

  - `payment_details.vat` (object)
    Informations sur la TVA (objet ; UE uniquement).

  - `payment_details.vat.percent` (number)
    Taux de TVA.

  - `payment_details.xsolla_balance_sum` (object)
    Montant débité du solde Xsolla.

  - `payment_details.xsolla_fee` (object)
    Frais Xsolla (objet).

  - `purchase` (object)
    Informations sur l'achat (objet).

  - `purchase.checkout` (object)
    Informations au moment du paiement (objet).

  - `purchase.checkout.amount` (number)
    Montant de l'achat.

  - `purchase.subscription` (object)
    Informations de l'abonnement (objet).

  - `purchase.subscription.amount` (number)
    Prix en monnaie réelle.

  - `purchase.subscription.date_create` (string)
    Date de création de l'abonnement. Date et heure selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `purchase.subscription.plan_id` (string)
    ID de plan (externe si le plan a été créé via API).

  - `purchase.subscription.subscription_id` (integer)
    ID d'abonnement dans la base de données Xsolla.

  - `purchase.subscription.tags` (array)
    Balises du plan.

  - `purchase.total` (object, required)
    Prix total d'achat (objet).

  - `purchase.total.amount` (number)
    Montant total du paiement.

  - `refund_details` (object)
    Détails du remboursement (objet).

  - `refund_details.author` (string)
    Initiateur du remboursement. La valeur du champ est passée conformément au 
tableau :


    
    
        Initiateur du remboursement
        Valeur du champ
    
    
    
    
        Jeu (via API).
        API
    
    
        Utilisateur du Compte éditeur (remboursement automatique).
        Adresse e-mail de l'utilisateur
    
    
        Utilisateur du Compte éditeur (avec l'assistance du service client Xsolla).
        support@xsolla.com
    
    
        Xsolla (avec l'assistance du service client Xsolla).
        support@xsolla.com

  - `refund_details.code` (integer)
    ID de code.

  - `refund_details.reason` (string)
    Motif de remboursement.

  - `settings` (object)
    Paramètres personnalisés de projet (objet).

  - `settings.merchant_id` (integer)
    ID de commerçant.

  - `settings.project_id` (integer)
    ID de projet. Ce paramètre se trouve dans le [Compte éditeur](https://publisher.xsolla.com/) à côté du nom du projet.

  - `transaction` (object, required)
    Détails de la transaction (objet).

  - `transaction.agreement` (integer)
    ID de contrat.

  - `transaction.dry_run` (integer)
    Transaction test. Le paramètre a la valeur 1 s'il s'agit d'une transaction test ou n'est pas envoyé si la transaction est réelle.

  - `transaction.external_id` (string)
    External ID de la transaction.

  - `transaction.id` (integer)
    ID de transaction.

  - `transaction.payment_method_order_id` (string)
    ID de paiement dans le système de paiement.

  - `user` (object)
    Informations sur l'utilisateur (objet).

  - `user.country` (string)
    Pays de l'utilisateur. Code pays à deux lettres majuscules selon la norme [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.email` (string)
    Adresse e-mail de l'utilisateur.

  - `user.id` (string, required)
    ID utilisateur.

  - `user.ip` (string)
    IP de l'utilisateur.

  - `user.name` (string)
    Nom d'utilisateur.

  - `user.phone` (string)
    Téléphone de l'utilisateur.

  - `user.zip` (string)
    ZIP ou code postal de l'utilisateur.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields