# Annulation de commande (sans données de paiement et de transaction)

Xsolla envoie le webhook order_canceled à l'URL spécifiée lorsque 
le paiement est annulé par l'utilisateur, le partenaire ou automatiquement. Le 
webhook inclut des informations sur les objets retournés et la commande annulée.

Le webhook n'est pas envoyé si le paiement n'a pas abouti, par exemple :
* l'interface de paiement a été ouverte, mais l'utilisateur n'a pas procédé au 
  paiement de la commande ;
* l'interface de paiement a été ouverte, mais des erreurs se sont produites lors 
  du paiement.

Le temps de traitement recommandé pour le webhook est de 3 secondes.

Endpoint: POST order-cancellation-separate
Version: 1.0

## Request fields (application/json):

  - `custom_parameters` (object)
    Informations supplémentaires.

  - `items` (array, required)
    Liste des objets achetés par l'utilisateur.

L'ensemble des paramètres inclus dans le tableau dépend de la version du 
webhook. La version 2 comprend des paramètres supplémentaires : is_free, 
is_bonus et is_bundle_content. Pour changer de version, passez son numéro 
dans le paramètre version de l'appel API [Update information about webhook 
settings](/fr/api/igs/operation/update-webhook/).

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

  - `order` (object, required)
    Informations sur commande.

  - `order.amount` (string, required)
    Coût total du panier en fonction de la devise sélectionnée.

  - `order.comment` (string,null, required)
    Commentaire de l'utilisateur sur la commande.

  - `order.coupons` (array)
    Coupons appliqués. Si aucun coupon n'a été appliqué, le tableau n'est pas renvoyé.

  - `order.coupons.code` (string)
    Code du coupon appliqué.

  - `order.coupons.external_id` (string)
    External ID.

  - `order.currency` (string, required)
    Devise de commande. L'UGS est utilisée pour la monnaie virtuelle et un code à trois lettres selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) pour les devises réelles.

  - `order.currency_type` (string, required)
    Type de devise de paiement. Pour une commande gratuite, la valeur unknown est spécifiée.
    Enum: "real", "virtual", "unknown", "loyalty_point"

  - `order.id` (integer, required)
    Identifiant unique de la commande de l'utilisateur côté Xsolla.

  - `order.invoice_id` (string,null, required)
    ID de facture pour les paiements en devises réelles. Les paiements en monnaie virtuelle ou les biens gratuits ont une valeur null.

  - `order.mode` (string, required)
    Mode de paiement. La valeur default est utilisée pour les paiements réels et sandbox pour les paiements test.
    Enum: "default", "sandbox"

  - `order.platform` (string,null, required)
    Plateforme de paiement. La valeur xsolla est utilisée pour les paiements via Xsolla. Pour les autres paiements, la valeur correspondant au nom de la plateforme de publication de jeux est utilisée : playstation_network, xbox_live, pc_standalone, nintendo_shop, google_play, app_store_ios, android_standalone, ios_standalone, android_other, ios_other, pc_other.
    Enum: "xsolla", "playstation_network", "xbox_live", "pc_standalone", "nintendo_shop", "google_play", "app_store_ios", "android_standalone", "ios_standalone", "android_other", "ios_other", "pc_other"

  - `order.promocodes` (array)
    Codes promo appliqués. Si aucun code promo n'a été appliqué, le tableau n'est pas renvoyé.

  - `order.promocodes.code` (string)
    Code promo appliqué.

  - `order.promotions` (array, required)
    Promotions s'appliquant à l'ensemble de la commande.
Le tableau est renvoyé dans les cas suivants :
 - Une promotion affecte le montant total de l'achat, par exemple un code promo avec le paramètre Discount on purchase ;
 - Aucune remise n'est appliquée à l'achat, mais des objets bonus sont ajoutés à la commande. Dans ce cas, les valeurs du coût avec remise ([amount_with_discount](/fr/webhooks/#operation/order-cancellation!path=order/promotions/amount_with_discount&t=request)) et sans remise ([amount_without_discount](/fr/webhooks/#operation/order-cancellation!path=order/promotions/amount_without_discount&t=request)) sont renvoyées et sont identiques, puisqu'aucune remise n'est appliquée.

Si aucune promotion n'est appliquée à l'ensemble de la commande, un tableau vide est renvoyé.

  - `order.promotions.amount_with_discount` (string)
    Coût total des objets bénéficiant d'une remise.

  - `order.promotions.amount_without_discount` (string)
    Coût total des objets sans remise.

  - `order.promotions.sequence` (integer)
    Ordre d'application de promotions.

  - `order.status` (string, required)
    Statut de la commande.

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

  - `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, required)
    Adresse e-mail de l'utilisateur.

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


## Response 200 fields

## Response 400 fields