Référence API

Vérification Xsolla

POST/v1/xsolla/verify

Vérifie si un utilisateur Xsolla, ou un abonnement, est abonné, avec l’ID marchand, l’ID de projet et la clé API Xsolla définis sur cette clé API (console → Clés API → Modifier → Vérification d’abonnement Xsolla). La réponse vient directement de Xsolla ; la passerelle ne facture rien et votre app décide quoi débloquer. Les abonnements trouvés sont mis en cache une minute.

#Paramètres de la requête

user_idstringfacultatif
Le user.id que votre app a mis dans le jeton de paiement Xsolla. Obligatoire si subscription_id n’est pas envoyé.
subscription_idintegerfacultatif
Un ID d’abonnement Xsolla, si l’app en a un. Envoyé avec user_id, l’abonnement doit appartenir à cet utilisateur.

subscribed vaut true pour tout abonnement réel de cet utilisateur dans le projet, y compris résilié ; active vaut true seulement tant qu’il peut être utilisé. Avec le renouvellement désactivé (state non_renewing), un abonnement reste actif jusqu’à expiry_time. in_trial vaut true tant que rien n’a été prélevé. Un utilisateur sans abonnement renvoie subscribed false et state not_found avec le statut 200. S’il en a plusieurs, l’abonnement actif qui dure le plus longtemps est renvoyé.

Chaque appel, y compris les réponses en cache et les échecs, apparaît dans Console → Journaux de requêtes comme une ligne xsolla-verify gratuite sur la clé qui l’a fait. Ces lignes ne comptent pas dans les requêtes. Abonnements Xsolla dans votre app →

#Erreurs associées

400 invalid_requestLe corps n’est pas du JSON, ou user_id et subscription_id manquent tous les deux.
400 xsolla_not_configuredCette clé API n’a pas encore d’ID marchand, d’ID de projet ni de clé API Xsolla.
401Jeton bearer invalide ou manquant.
429Limite par clé des appels de vérification : 120 par minute par défaut, relevée pour une clé par le support. Attendez Retry-After et gardez la dernière réponse.
502 xsolla_credentials_invalidXsolla a refusé la clé API enregistrée. Saisissez-en une nouvelle sur la clé.
503 xsolla_unavailableXsolla n’a pas répondu à temps. Réessayez dans quelques secondes.

Table complète des codes d'erreur →

#Exemple de requête

curl https://www.aisplice.store/v1/xsolla/verify \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "USER_ID_IN_THE_PAYMENT_TOKEN"}'

#Réponse

response.json

{
  "project_id": 273204,
  "subscribed": true,
  "active": true,
  "in_trial": false,
  "state": "active",
  "subscription_id": 249579,
  "user_id": "user-8f2c",
  "plan_id": 601,
  "plan_external_id": "weekly",
  "expiry_time": 1793000000,
  "auto_renewing": true,
  "checked_at": 1790400000
}

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.

PrécédentVérification Google Play SuivantAbonnements Google Play