aisplice

API-Referenz

Xsolla-Prüfung

POST/v1/xsolla/verify

Prüft mit der Händler-ID, Projekt-ID und dem Xsolla-API-Schlüssel dieses API-Schlüssels (Konsole → API-Schlüssel → Bearbeiten → Xsolla-Abo-Prüfung), ob ein Xsolla-Nutzer oder ein Abo aktiv abonniert ist. Die Antwort kommt direkt von Xsolla; das Gateway berechnet nichts, und Ihre App entscheidet, was freigeschaltet wird. Gefundene Abos werden eine Minute zwischengespeichert.

#Anfrageparameter

  • user_idstringoptional

    Die user.id, die Ihre App in das Xsolla-Zahlungstoken geschrieben hat. Pflicht, wenn keine subscription_id gesendet wird.

  • subscription_idintegeroptional

    Eine Xsolla-Abo-ID, falls die App eine hat. Zusammen mit user_id gesendet, muss das Abo diesem Nutzer gehören.

subscribed ist true für jedes echte Abo dieses Nutzers im Projekt, auch gekündigte; active ist nur true, solange es genutzt werden darf. Bei ausgeschalteter Verlängerung (state non_renewing) bleibt ein Abo bis expiry_time aktiv. in_trial ist true, solange noch nichts abgebucht wurde. Ein Nutzer ohne Abo erhält subscribed false und state not_found mit Status 200. Hat ein Nutzer mehrere, wird das aktive mit der längsten Laufzeit zurückgegeben.

Jeder Aufruf, auch zwischengespeicherte Antworten und Fehler, erscheint in Konsole → Anfrageprotokolle als kostenlose xsolla-verify-Zeile beim aufrufenden Schlüssel. Diese Zeilen zählen nicht zu den Anfragen. Xsolla-Abos in Ihrer App →

#Zugehörige Fehler

  • 400 invalid_requestDer Body ist kein JSON, oder user_id und subscription_id fehlen beide.
  • 400 xsolla_not_configuredDieser API-Schlüssel hat noch keine Xsolla-Händler-ID, Projekt-ID und keinen API-Schlüssel.
  • 401Ungültiges oder fehlendes Bearer-Token.
  • 429Limit pro Schlüssel für Prüfaufrufe: standardmäßig 120 pro Minute, vom Support pro Schlüssel erhöhbar. Warten Sie Retry-After ab und behalten Sie die letzte Antwort.
  • 502 xsolla_credentials_invalidXsolla hat den gespeicherten API-Schlüssel abgelehnt. Tragen Sie am Schlüssel einen neuen ein.
  • 503 xsolla_unavailableXsolla hat nicht rechtzeitig geantwortet. Versuchen Sie es in ein paar Sekunden erneut.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

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"}'

#Antwort

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
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückGoogle-Play-Abo-PrüfungWeiterGoogle-Play-Abos