Prélever sur un compte enregistré

Prélever sur un compte enregistréServer-side

post/projects/{project_id}/users/{user_id}/payments/{type}/{account_id}

Facture un utilisateur via un compte de paiement enregistré.

Note

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

Remarque

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

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

ID de projet.

user_id

required

string

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

required

string

Type de compte de paiement.

Enum:	Description
alipayplus_boost	Boost.
alipayplus_cn	Alipay.
alipayplus_dana	DANA.
alipayplus_gcash	GCash.
alipayplus_hk	Alipay (Hong Kong).
alipayplus_maya	Maya.
alipayplus_rabbitlinepay	Rabbit LINE pay.
alipayplus_tng	Touch 'n Go.
alipayplus_truemoney	TrueMoney Wallet.
amazon	Amazon Pay.
card	Cartes bancaires.
klarna	Klarna. L'enregistrement de compte de paiement est disponible uniquement pour les États-Unis, le Royaume-Uni, la Suède, l'Allemagne, l'Autriche, la Norvège, la Finlande, le Danemark et les Pays-Bas.
mercadopago	Mercado Pago.
paypal	PayPal.
paysafecard_eu	Paysafecard (UE).
paysafecard_us	Paysafecard (É.-U.).
skrill	Skrill Digital Wallet.
softbank_au	au Easy Payment.
softbank_docomo	Docomo.
softbank_paypay	PayPay.
softbank_softbank2	SoftBank.
softbank_ymobile	Y!mobile.
toss	Toss Wallet.

account_id

required

integer

ID du compte enregistré dans la base de données Xsolla.

Request Body schema: application/json

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.

active_date	string Date de dernière visite selon la norme ISO 8601.
additional_verification	boolean Indique si le joueur utilise des méthodes de vérification de compte.
character_customized	boolean Indique si le joueur a personnalisé son personnage.
chat_activity	boolean Indique si le joueur utilise la fonction de chat.
completed_tasks	integer Nombre de tâches/objectifs terminés.
forum_activity	boolean Indique si le joueur utilise la fonction forum.
items_used	boolean Indique si le joueur utilise des objets achetés dans le jeu.
karma_points	integer Karma du joueur.
last_change_password_date	string Date de dernier changement de mot de passe selon la norme ISO 8601.
non_premium_currency	number <float> Quantité de la monnaie non-premium.
notifications_enabled	boolean Indique si le joueur a activé les notifications.
profile_completed	boolean Indique si le joueur a ajouté des informations supplémentaires à son profil.
profile_image_added	boolean Indique si le joueur a téléchargé une image de profil.
pvp_activity	boolean Indique si le joueur participe à des combats JcJ.
registration_date	string Date de création de compte selon la norme ISO 8601.
session_time	string Durée moyenne de session selon la norme ISO 8601.
social_networks_added	boolean Indique si le joueur a connecté des profils de médias sociaux.
total_bans	integer Nombre de fois que le joueur a été banni du chat/forum.
total_characters	integer Nombre de personnages dans le jeu.
total_clans	integer Nombre de clans dont le joueur est membre.
total_friends	integer Nombre d'amis.
total_game_events	integer Nombre d'événements en jeu auxquels le joueur a participé.
total_gifts	integer Nombre de cadeaux en jeu que le joueur a envoyés/reçus.
total_hours	integer Nombre total d'heures passées dans le jeu.
total_inventory_value	number <float> Valeur totale de l'inventaire en monnaie de jeu.
total_sum	number <float> Montant total des paiements.
tutorial_completed	boolean Indique si le joueur a terminé le tutoriel du jeu.
unlocked_achievements	integer Nombre de réalisations débloquées.
user_level	integer Niveau, réputation ou rang du joueur.
win_rate	integer Taux de victoire du joueur.

object

Informations sur l'achat.

object

Informations sur le paiement.

amount	number <float> Montant de l'achat.
currency	string Devise d'achat. Code de devise à trois lettres selon la norme ISO 4217.

object <= 4000 characters

value

string

object

Informations sur la monnaie virtuelle.

quantity

number <float>

Montant de l'achat en monnaie virtuelle.

object

Paramètres d'achat.

currency	string Devise de paiement préférée. Code de devise à trois lettres selon la norme ISO 4217.
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.
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: 1057 1015 3006 1801 1803 1039 3031 1203 3006 1201 1002 1089 2031 1046 5004
mode	string Définissez sur `sandbox` pour tester le processus de paiement. Supprimez le paramètre pour effectuer des paiements réels.

object

Informations sur l'utilisateur.

required

string

Adresse IP de l'utilisateur.

object

Informations de la personne morale.

address	string Adresse légale complète.
country	string Pays de constitution. Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2.
name	string Nom légal complet.
vat_id	string Numéro d'identification fiscal.

name

string

Nom d'utilisateur.

Responses

201

Created.

422

Unprocessable Entity.

Request samples

application/json

{"purchase": {"description": {"value": "currency purchase"
},
"virtual_currency": {"quantity": 100
}
},
"settings": {"currency": "USD",
"external_id": "ext123",
"mode": "sandbox"
},
"user": {"ip": "111.11.11.11",
"legal": {"address": "17 Crown Street London SW2 0JW United Kingdom",
"country": "GB",
"name": "My Awesome Company",
"vat_id": "GB111111111"
},
"name": "John Smith"
}
}

Response samples

application/json

{"transaction_id": 123458390
}