# Prélever sur un compte enregistré

Facture un utilisateur via un compte de paiement enregistré.


NoteEn mode bac à sable, cet appel API fonctionne uniquement avec les cartes de test dépourvues de la fonction 3-D Secure.





RemarquePour que l'appel API fonctionne correctement, configurez un délai d'attente de 2 minutes.

Endpoint: POST /projects/{project_id}/users/{user_id}/payments/{type}/{account_id}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID de projet.

  - `user_id` (string, required)
    ID utilisateur unique dans le jeu stocké de votre côté. Assurez-vous de passer l'ID existant. En cas d'erreur, consultez les réponses de la FAQ.

  - `type` (string, required)
    Type de compte de paiement.
    Enum: "card", "ais", "alipayplus_boost", "alipayplus_cn", "alipayplus_dana", "alipayplus_gcash", "alipayplus_hk", "alipayplus_kplus", "alipayplus_maya", "alipayplus_rabbitlinepay", "alipayplus_tng", "alipayplus_truemoney", "amazon", "klarna", "mercadopago", "nupay", "paidy", "paypal", "paysafecard_eu", "paysafecard_us", "skrill", "softbank_au", "softbank_docomo", "softbank_paypay", "softbank_softbank2", "softbank_ymobile", "toss"

  - `account_id` (integer, required)
    ID du compte enregistré dans la base de données Xsolla.

## Request fields (application/json):

  - `custom_parameters` (object)
    Cet objet comprend des paramètres pour configurer les filtres anti-fraude. La liste des paramètres est présentée ci-dessous. Pour des paramètres personnalisés, contactez votre responsable de la réussite client ou envoyez un e-mail à [csm@xsolla.com](mailto:csm@xsolla.com).

  - `custom_parameters.active_date` (string)
    Date de dernière visite selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.additional_verification` (boolean)
    Indique si le joueur utilise des méthodes de vérification de compte.

  - `custom_parameters.character_customized` (boolean)
    Indique si le joueur a personnalisé son personnage.

  - `custom_parameters.chat_activity` (boolean)
    Indique si le joueur utilise la fonction de chat.

  - `custom_parameters.completed_tasks` (integer)
    Nombre de tâches/objectifs terminés.

  - `custom_parameters.forum_activity` (boolean)
    Indique si le joueur utilise la fonction forum.

  - `custom_parameters.items_used` (boolean)
    Indique si le joueur utilise des objets achetés dans le jeu.

  - `custom_parameters.karma_points` (integer)
    Karma du joueur.

  - `custom_parameters.last_change_password_date` (string)
    Date de dernier changement de mot de passe selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.non_premium_currency` (number)
    Quantité de la monnaie non-premium.

  - `custom_parameters.notifications_enabled` (boolean)
    Indique si le joueur a activé les notifications.

  - `custom_parameters.profile_completed` (boolean)
    Indique si le joueur a ajouté des informations supplémentaires à son profil.

  - `custom_parameters.profile_image_added` (boolean)
    Indique si le joueur a téléchargé une image de profil.

  - `custom_parameters.pvp_activity` (boolean)
    Détermine la participation du joueur à des combats JcJ (joueur(s) contre joueur(s)).

  - `custom_parameters.registration_date` (string)
    Date de création de compte selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.session_time` (string)
    Durée moyenne de session selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.social_networks_added` (boolean)
    Indique si le joueur a connecté des profils de médias sociaux.

  - `custom_parameters.total_bans` (integer)
    Nombre de fois que le joueur a été banni du chat/forum.

  - `custom_parameters.total_characters` (integer)
    Nombre de personnages dans le jeu.

  - `custom_parameters.total_clans` (integer)
    Nombre de clans dont le joueur est membre.

  - `custom_parameters.total_friends` (integer)
    Nombre d'amis.

  - `custom_parameters.total_game_events` (integer)
    Nombre d'événements en jeu auxquels le joueur a participé.

  - `custom_parameters.total_gifts` (integer)
    Nombre de cadeaux en jeu que le joueur a envoyés/reçus.

  - `custom_parameters.total_hours` (integer)
    Nombre total d'heures passées dans le jeu.

  - `custom_parameters.total_inventory_value` (number)
    Valeur totale de l'inventaire en monnaie de jeu.

  - `custom_parameters.total_sum` (number)
    Montant total des paiements.

  - `custom_parameters.tutorial_completed` (boolean)
    Indique si le joueur a terminé le tutoriel du jeu.

  - `custom_parameters.unlocked_achievements` (integer)
    Nombre de réalisations débloquées.

  - `custom_parameters.user_level` (integer)
    Niveau, réputation ou rang du joueur.

  - `custom_parameters.win_rate` (integer)
    Taux de victoire du joueur.

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

  - `purchase.checkout` (object)
    Informations sur le paiement.

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

  - `purchase.checkout.currency` (string)
    Devise d'achat. Code de devise à trois lettres selon la norme [ISO 4217](https://developers.xsolla.com/fr/doc/pay-station/references/supported-currencies/).

  - `purchase.description` (object)

  - `purchase.description.value` (string)

  - `purchase.virtual_currency` (object)
    Informations sur la monnaie virtuelle.

  - `purchase.virtual_currency.quantity` (number)
    Montant de l'achat en monnaie virtuelle.

  - `settings` (object)
    Paramètres d'achat.

  - `settings.currency` (string)
    Devise de paiement préférée. Code de devise à trois lettres selon la norme [ISO 4217](https://developers.xsolla.com/fr/doc/pay-station/references/supported-currencies/).

  - `settings.external_id` (string)
    ID de transaction dans le jeu. Il doit être unique pour chaque paiement utilisateur. Reportez-vous à la documentation pour des informations détaillées.

  - `settings.mock_code` (integer)
    Un code d'erreur à reproduire lors des tests du processus de paiement via PayPal en mode bac à sable. Assurez-vous de passer le paramètre "mode":"sandbox" pour que le processus fonctionne correctement.
    Enum: 1002, 1015, 1039, 1046, 1057, 1089, 1201, 1203, 1801, 1803, 2031, 3006, 3031, 5004

  - `settings.mode` (string)
    Définissez sur sandbox pour tester le processus de paiement. Supprimez le paramètre pour effectuer des paiements réels.

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

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

  - `user.legal` (object)
    Informations de la personne morale.

  - `user.legal.address` (string)
    Adresse légale complète.

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

  - `user.legal.name` (string)
    Nom légal complet.

  - `user.legal.vat_id` (string)
    Numéro d'identification fiscal.

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

## Response 201 fields (application/json):

  - `transaction_id` (integer)


## Response 422 fields