aisplice

Riferimento API

Verifica Xsolla

POST/v1/xsolla/verify

Verifica se un utente Xsolla, o un abbonamento, è abbonato, con l’ID commerciante, l’ID progetto e la chiave API Xsolla impostati su questa chiave API (console → Chiavi API → Modifica → Verifica abbonamento Xsolla). La risposta arriva direttamente da Xsolla; il gateway non addebita nulla e la tua app decide cosa sbloccare. Gli abbonamenti trovati restano in cache per un minuto.

#Parametri della richiesta

  • user_idstringfacoltativo

    Lo user.id che la tua app ha messo nel token di pagamento Xsolla. Obbligatorio se non invii subscription_id.

  • subscription_idintegerfacoltativo

    Un ID abbonamento Xsolla, se l’app ne ha uno. Inviato insieme a user_id, l’abbonamento deve appartenere a quell’utente.

subscribed è true per ogni abbonamento reale di questo utente nel progetto, anche disdetto; active è true solo finché può essere usato. Con il rinnovo automatico spento (state non_renewing) l’abbonamento resta attivo fino a expiry_time. in_trial è true finché non è stato addebitato nulla. Un utente senza abbonamento risponde subscribed false e state not_found con stato 200. Se ne ha più di uno, viene restituito quello attivo che dura di più.

Ogni chiamata, comprese risposte in cache e errori, compare in Console → Log delle richieste come riga xsolla-verify gratuita sulla chiave che l’ha fatta. Queste righe non contano tra le richieste. Abbonamenti Xsolla nella tua app →

#Errori correlati

  • 400 invalid_requestIl corpo non è JSON, oppure mancano sia user_id sia subscription_id.
  • 400 xsolla_not_configuredQuesta chiave API non ha ancora ID commerciante, ID progetto e chiave API Xsolla.
  • 401Bearer token non valido o mancante.
  • 429Limite per chiave delle chiamate di verifica: 120 al minuto di default, aumentabile per una chiave dal supporto. Attendi Retry-After e mantieni l’ultima risposta.
  • 502 xsolla_credentials_invalidXsolla ha rifiutato la chiave API salvata. Inseriscine una nuova sulla chiave.
  • 503 xsolla_unavailableXsolla non ha risposto in tempo. Riprova tra qualche secondo.

Tabella completa dei codici di errore →

#Esempio di richiesta

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

#Risposta

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
}

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteVerifica Google PlaySuccessivoAbbonamenti Google Play