aisplice

Referência da API

Verificação Xsolla

POST/v1/xsolla/verify

Verifica se um usuário da Xsolla, ou uma assinatura, está assinado, com o ID de comerciante, o ID do projeto e a chave de API da Xsolla definidos nesta chave de API (console → Chaves de API → Editar → Verificação de assinatura Xsolla). A resposta vem direto da Xsolla; o gateway não cobra nada e seu app decide o que liberar. Assinaturas encontradas ficam em cache por um minuto.

#Parâmetros da requisição

  • user_idstringopcional

    O user.id que seu app colocou no token de pagamento da Xsolla. Obrigatório se subscription_id não for enviado.

  • subscription_idintegeropcional

    Um ID de assinatura da Xsolla, se o app tiver. Enviado junto com user_id, a assinatura precisa ser desse usuário.

subscribed é true para qualquer assinatura real desse usuário no projeto, incluindo canceladas; active é true só enquanto pode ser usada. Com a renovação automática desligada (state non_renewing), a assinatura continua ativa até expiry_time. in_trial é true enquanto ainda não houve cobrança. Um usuário sem assinatura responde subscribed false e state not_found com status 200. Se tiver várias, é retornada a ativa que dura mais.

Cada chamada, incluindo respostas em cache e falhas, aparece em Console → Logs de requisições como uma linha xsolla-verify gratuita na chave que a fez. Essas linhas não contam como requisições. Assinaturas Xsolla no seu app →

#Erros relacionados

  • 400 invalid_requestO corpo não é JSON, ou user_id e subscription_id estão ambos ausentes.
  • 400 xsolla_not_configuredEsta chave de API ainda não tem ID de comerciante, ID do projeto e chave de API da Xsolla.
  • 401Bearer token inválido ou ausente.
  • 429Limite por chave de chamadas de verificação: 120 por minuto por padrão, aumentado para uma chave pelo suporte. Aguarde o Retry-After e mantenha a última resposta.
  • 502 xsolla_credentials_invalidA Xsolla recusou a chave de API salva. Informe uma nova na chave.
  • 503 xsolla_unavailableA Xsolla não respondeu a tempo. Tente de novo em alguns segundos.

Tabela completa de códigos de erro →

#Exemplo de requisição

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

#Resposta

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
}

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.

AnteriorVerificação do Google PlayPróximoAssinaturas do Google Play