# Paiement Lorsque l'utilisateur effectue un paiement, Xsolla envoie les informations sur le paiement via un webhook de type payment à l'URL du webhook. Les codes de réponse attendus sont décrits dans la section Responses, mais vous pouvez également utiliser d’autres codes de réponse : Code de réponse Description 200, 201, 204 Réponse de réussite. 4xx Une erreur s'est produite. Par exemple, si l'utilisateur spécifié est introuvable ou si une signature non valide a été passée. 5xx Erreur serveur temporaire. Lorsque cette réponse est reçue, Xsolla réessaie automatiquement d’envoyer le webhook, en espaçant progressivement les tentatives jusqu’à ce que votre écouteur confirme la réception. Le nombre maximal de tentatives est de 12 sur une période de 48 heures. 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 le compte de paiement enregistré Les informations relatives au mode de paiement enregistré sont passées à l'objet personnalisé payment_account. 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. Ajouter l'objet de la commande au webhook Les informations relatives à la commande sont passées dans l'objet order du webhook Paiement. Envoyer paramètres utilisateur nécessaires seulement sans données sensibles Seules les informations suivantes sur l'utilisateur sont passées dans le webhook :ID ;pays. Afficher BIN et suffixe de carte Les informations suivantes sur le numéro de la carte bancaire sont passées dans le webhook :les 6 premiers chiffres du paramètre card_bin ;les 4 derniers chiffres du card_suffix. Afficher marque de carte La marque de la carte utilisée pour effectuer le paiement. Par exemple, Mastercard ou Visa. Remarque L'ensemble des champs envoyés dans un webhook dépend :des paramètres avancés configurés dans le Compte éditeur ;des paramètres personnalisés configurés côté Xsolla.Si vous avez des questions, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com. Endpoint: POST payment 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.coupon` (object) Informations sur le coupon (objet ; si un coupon a été utilisé lors de la création de l'abonnement). - `purchase.coupon.campaign_code` (string) Code de campagne. - `purchase.coupon.coupon_code` (string) Code de coupon. - `purchase.gift` (object) Informations sur le cadeau (objet). - `purchase.gift.giver_id` (string) ID du donneur. - `purchase.gift.hide_giver_from_receiver` (string) Détermine l'affichage de l'identité du donneur au destinataire. - `purchase.gift.message` (string) Message du donneur. - `purchase.gift.receiver_email` (string) Adresse e-mail du destinataire du cadeau. - `purchase.gift.receiver_id` (string) ID du destinataire du cadeau. - `purchase.order` (object) Objet contenant des informations sur une commande. Pour recevoir ces informations, réglez la bascule Ajouter l'objet de la commande au webhook sur On dans le [Compte éditeur](https://publisher.xsolla.com/) dans la section Project settings > Webhooks > Advanced settings. - `purchase.order.id` (integer) ID de commande. - `purchase.order.lineitems` (array) Tableau de paramètres contenant des informations sur les objets. - `purchase.order.lineitems.price` (object) Informations sur le prix de l'objet. - `purchase.order.lineitems.price.amount` (number) Prix total de l'objet dans la devise sélectionnée. - `purchase.order.lineitems.price.currency` (string) Devise du prix de l'objet. - `purchase.order.lineitems.quantity` (integer) Quantité de l'objet. - `purchase.order.lineitems.sku` (string) UGS de l'objet. - `purchase.promotions` (array) Promotions appliquées à cette transaction. - `purchase.promotions.id` (integer) ID de promotion. - `purchase.promotions.technical_name` (string) Nom technique de la promotion. - `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.date_next_charge` (string) Prochaine date de facturation. 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.product_id` (string) ID de produit (s'il est passé dans le jeton d'accès). - `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. - `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. Pour obtenir des informations détaillée, reportez-vous à la [FAQs](/fr/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id). - `transaction.id` (integer) ID de transaction. - `transaction.payment_date` (string) Date de paiement. - `transaction.payment_method` (integer) ID de mode de paiement. - `transaction.payment_method_name` (string) Nom de mode de paiement. - `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