Riferimento API

Verifica Google Play

POST/v1/google-play/verify

Verifica un token di acquisto Google Play con l'account di servizio impostato su questa chiave API (Console → Chiavi API → Modifica → Verifica abbonamenti Google Play). La risposta arriva direttamente da Google; il gateway non addebita nulla e la tua app decide cosa sbloccare. Le risposte restano in cache per un minuto per token.

#Parametri della richiesta

purchase_tokenstringobbligatorio
Il token di acquisto di Play Billing. In Flutter in_app_purchase è purchaseDetails.verificationData.serverVerificationData.

subscribed è true per qualsiasi abbonamento reale di questa app, compresi quelli scaduti; active è true solo finché può essere usato. Gli abbonamenti annullati restano active fino a expiry_time, perché è stato disattivato solo il rinnovo automatico. in_trial è true mentre il periodo corrente è una prova gratuita; in quel caso expiry_time indica la fine della prova. I token sconosciuti restituiscono subscribed false e state NOT_FOUND con stato 200.

La guida spiega passo per passo come configurare Google, chiamarlo da un'app Flutter e decidere cosa sbloccare. Abbonamenti Google Play nella tua app →

Ogni chiamata, comprese le risposte in cache e gli errori, compare in Console → Registro delle richieste come riga gratuita “Verifica Google Play” sulla chiave che l'ha effettuata, con il risultato, l'ID ordine e gli ultimi caratteri del token. Lì puoi cercare per token di acquisto completo, per i suoi ultimi caratteri o per ID ordine. Queste righe sono escluse dal conteggio delle richieste.

#Errori correlati

400 invalid_requestIl corpo non è JSON oppure manca purchase_token.
400 google_play_not_configuredQuesta chiave API non ha ancora un nome del pacchetto e un account di servizio.
401Bearer token non valido o mancante.
429Limite per chiave sulle chiamate di verifica: 120 al minuto per impostazione predefinita, aumentabile per una chiave dall'assistenza. Le impostazioni Google Play della chiave mostrano il suo limite. Attendi Retry-After e conserva l'ultima risposta.
502 google_play_api_disabledLa Google Play Android Developer API non è attiva nel progetto Google Cloud dell'account di servizio. Attivala e riprova dopo qualche minuto.
502 google_play_permission_deniedGoogle ha negato l'accesso: invita l'account di servizio in Play Console con l'autorizzazione a visualizzare i dati finanziari e a gestire ordini e abbonamenti. I nuovi permessi possono richiedere fino a un giorno.
502 google_play_credentials_invalidGoogle ha rifiutato la chiave dell'account di servizio salvata. Caricane una nuova sulla chiave.
503 google_play_unavailableGoogle non ha risposto in tempo. Riprova tra qualche secondo.

Tabella completa dei codici di errore →

#Esempio di richiesta

curl https://www.aisplice.store/v1/google-play/verify \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchase_token": "PURCHASE_TOKEN_FROM_PLAY_BILLING"}'

#Risposta

response.json

{
  "package_name": "com.example.app",
  "subscribed": true,
  "active": true,
  "in_trial": false,
  "state": "SUBSCRIPTION_STATE_ACTIVE",
  "product_id": "vip_monthly",
  "expiry_time": 1793000000,
  "auto_renewing": true,
  "acknowledged": true,
  "test_purchase": false,
  "order_id": "GPA.3300-1111-2222-44444..2",
  "checked_at": 1790400000
}

Non hai ancora risolto?

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

PrecedenteElenco dei modelli SuccessivoVerifica Xsolla