Xsolla-logo

Prélever sur un compte enregistré

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

Facture un utilisateur via un compte de paiement enregistré.

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_rabbitlinepay

Rabbit LINE pay.

alipayplus_tng

Touch 'n Go.

alipayplus_truemoney

TrueMoney Wallet.

amazon

Amazon Pay.

card

Cartes bancaires.

paypal

PayPal.

paysafecard_eu

Paysafecard (UE).

paysafecard_us

Paysafecard (É.-U.).

skrill

Skrill Digital Wallet.

softbank_paypay

PayPay.

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.

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.

ip
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
{
  • "card": {
    },
  • "purchase": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "transaction_id": 123458390
}