# 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 votre compte, 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 votre 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.
    
    
        Afficher des informations sur le motif du remboursement.
        Informations détaillées sur les motifs de remboursement.
    



Codes de remboursement :


    
    
        Code
        Motif
        Description
    
    
    
    
        1
        Cancellation by the user request / the game request
        Annulation effectuée depuis le compte.
    
    
        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 – AFS reject
        Transaction refusée : le système antifraude Xsolla a détecté une fraude potentielle.
    
    
        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é : le système de paiement a détecté une fraude potentielle. Recommandation : bloquez cet utilisateur.
    
    
        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 du compte affirme ne pas avoir effectué cette transaction. Recommandation : bloquez cet utilisateur.
    
    
        12
        Potential fraud – friendly fraud
        Le titulaire légitime de la carte a contesté cette transaction.
    
    
        13
        Duplicate
        Transaction dupliquée pour la même facture.
    
    
        21
        Potential fraud – BIN attack
        Cartes volées provenant d'un ou plusieurs BIN dans un même lot. Un afflux soudain de tentatives partageant une plage de BIN sur une courte période, souvent avec des numéros de carte énumérés, est un indicateur clé.
    
    
        22
        Potential fraud – monetization fraud
        Carte volée utilisée pour acheter des objets échangeables destinés à la revente.
    
    
        23
        Potential fraud – low-scale card fraud
        Cartes volées provenant d'un ou plusieurs BIN. Attaque moins répandue et coordonnée que l'attaque par BIN (code de remboursement 21).
    
    
        24
        Potential fraud – regional price abuse
        Abus de la tarification régionale ou revente de clés. Des utilisateurs ont contourné les prix régionaux en falsifiant leur localisation ou leur mode de paiement afin d'acheter à bas prix et de revendre les objets sur des marchés plus chers.
    
    
        25
        Potential fraud – partner or PS exploit
        Vol d'identifiants et prise de contrôle de compte : compromission d'un compte ou d'une intégration côté partenaire ou système de paiement, plutôt qu'une utilisation frauduleuse directe de cartes.
    
    
        26
        Potential fraud – not definable
        Fraude confirmée, mais le type d'attaque ne peut pas être déterminé avec certitude.
    
    
        27
        Fraud notification from PS – linked transactions
        La transaction n'a pas été signalée comme frauduleuse par le système de paiement, mais elle est liée, par une carte ou un appareil commun, à des transactions ayant fait l'objet d'un remboursement pour fraude.

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)
    Objet contenant les données sur les retenues à la source appliquées dans certains pays pour les transactions transfrontalières.

  - `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)
    Pourcentage du taux de retenue à la source.

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

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

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

  - `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.amount` (number)
    Montant.

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

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

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

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

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

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

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

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

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

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

  - `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.repatriation_commission.amount` (number)
    Montant.

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

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

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

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

  - `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.amount` (number)
    Montant.

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

  - `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.amount` (number)
    Montant.

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

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

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

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

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

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

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

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

  - `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.checkout.currency` (string)
    Devise. Code de devise à trois lettres selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

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

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

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

  - `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.

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

  - `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 (remboursement automatique).
        Adresse e-mail de l'utilisateur
    
    
        Utilisateur du compte (assisté par le service client de 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 du projet. Vous trouverez ce paramètre dans votre [compte](/fr/webhooks/overview/#business-accounts), à 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