Referencia de la API

Verificación de Xsolla

POST/v1/xsolla/verify

Comprueba si un usuario de Xsolla, o una suscripción, está suscrito, con el ID de comerciante, el ID de proyecto y la clave API de Xsolla configurados en esta clave API (consola → Claves API → Editar → Verificación de suscripción de Xsolla). La respuesta viene directamente de Xsolla; la pasarela no cobra nada y tu app decide qué desbloquear. Las suscripciones encontradas se guardan en caché un minuto.

#Parámetros de la solicitud

user_idstringopcional
El user.id que tu app puso en el token de pago de Xsolla. Obligatorio si no se envía subscription_id.
subscription_idintegeropcional
Un ID de suscripción de Xsolla, si la app lo tiene. Si se envía junto con user_id, la suscripción debe pertenecer a ese usuario.

subscribed es true para cualquier suscripción real de este usuario en el proyecto, incluidas las canceladas; active es true solo mientras se puede usar. Con la renovación desactivada (state non_renewing) la suscripción sigue activa hasta expiry_time. in_trial es true mientras aún no se ha cobrado. Un usuario sin suscripción responde subscribed false y state not_found con estado 200. Si tiene varias, se devuelve la activa que dura más.

Cada llamada, incluidas las respuestas en caché y los fallos, aparece en Consola → Registros de solicitudes como una fila xsolla-verify gratuita en la clave que la hizo. Estas filas no cuentan como solicitudes. Suscripciones de Xsolla en tu app →

#Errores relacionados

400 invalid_requestEl cuerpo no es JSON, o faltan user_id y subscription_id.
400 xsolla_not_configuredEsta clave API aún no tiene ID de comerciante, ID de proyecto ni clave API de Xsolla.
401Bearer token no válido o ausente.
429Límite por clave de llamadas de verificación: 120 por minuto por defecto; soporte puede subirlo para una clave. Espera Retry-After y conserva la última respuesta.
502 xsolla_credentials_invalidXsolla rechazó la clave API guardada. Introduce una nueva en la clave.
503 xsolla_unavailableXsolla no respondió a tiempo. Reinténtalo en unos segundos.

Tabla completa de códigos de error →

#Ejemplo de solicitud

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

#Respuesta

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
}

¿Sigues con el problema?

Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.

AnteriorVerificación de Google Play SiguienteSuscripciones de Google Play