# Remboursement partiel

Lorsqu'un remboursement partiel est effectué, Xsolla envoie les détails de la 
transaction annulée via un webhook de type partial_refund à l'URL du webhook. 
Pour en savoir plus sur le processus de remboursement partiel, consultez ces 
instructions.

Lorsque vous enregistrez l'URL du webhook dans le Compte éditeur, vous pouvez 
activer les autorisations pour recevoir des informations détaillées dans les 
webhooks. Pour ce faire, activez la bascule correspondante dans la section Project 
settings > Webhooks > Advanced settings.


Note
Si vous avez créé un Compte éditeur le 22 janvier 2025 ou avant, les bascules se trouvent dans la section Project 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.
    
    
        3
        Integration error
        Problèmes d'intégration entre Xsolla et le jeu.Recommandation : n'ajoutez pas l'utilisateur à la liste noire.
    
    
        5
        Test payment
        Transaction test suivie d'une annulation.Recommandation : n'ajoutez pas l'utilisateur à la liste de noire.
    
    
        7
        Fraud notification from PS
        Paiement refusé : le système de paiement a détecté une fraude potentielle. Recommandation : bloquez cet utilisateur.
    
    
        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.

Endpoint: POST partial-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.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.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.total` (object, required)
    Prix total d'achat (objet).

  - `purchase.total.amount` (number)
    Montant du remboursement partiel.

  - `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 é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.date` (string)
    Date de remboursement.

  - `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.date` (string)
    Date de transaction.

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

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