Gestire abbonamenti e acquisti una tantum

Nell'ambito delle attività quotidiane, potrebbe essere necessario intraprendere azioni di gestione relative ad abbonamenti o acquisti una tantum. Ad esempio, il tuo servizio clienti potrebbe dover emettere rimborsi totali o parziali per gli utenti oppure potresti dover revocare i diritti in determinati casi. Puoi gestire gli ordini da Play Console o, se vuoi gestirli dal tuo sistema, puoi farlo utilizzando l'API Google Play Developer.

Annullare gli abbonamenti

Gli annullamenti degli abbonamenti possono essere avviati dagli utenti o dagli sviluppatori.

Annullamenti avviati dall'utente

Gli utenti possono annullare un abbonamento Google Play in qualsiasi momento utilizzando il Play Store. Se applicabile, devi anche fornire agli utenti un'opzione per annullare i loro abbonamenti nella tua app e sul tuo sito web.

Il modo più semplice per consentire agli utenti di annullare volontariamente l'abbonamento è fornire deep link nella tua app al Play Store, dove possono visualizzare e gestire i propri abbonamenti.

Annullamenti avviati dallo sviluppatore

In qualità di sviluppatore, potresti anche dover attivare gli annullamenti dal tuo backend. L'API purchases.subscriptions.cancel consente di annullare l'acquisto di un abbonamento. Ad esempio, puoi utilizzare questo metodo per disattivare un servizio legacy. L'annullamento di un abbonamento non comporta un rimborso e l'utente mantiene l'accesso fino alla fine del periodo di fatturazione corrente.

Questo metodo ti consente di specificare i seguenti tipi di annullamenti nel parametro del corpo della richiesta cancellationType:

  • USER_REQUESTED_STOP_RENEWALS: annulla l'abbonamento come se gli utenti lo avessero annullato dal Play Store. Eventuali pagamenti rateali continueranno per il resto del periodo di impegno corrente. Dal Play Store, gli utenti possono ripristinare l'abbonamento prima della scadenza o riabbonarsi dopo la scadenza, se l'opzione è attivata per il piano base.

  • DEVELOPER_REQUESTED_STOP_PAYMENTS: annulla l'abbonamento e impedisce ulteriori pagamenti. Gli utenti non possono ripristinare o riabbonarsi all'abbonamento dal Play Store, ma puoi consentire loro di abbonarsi di nuovo all'interno della tua app.

Consenti agli utenti di ripristinare gli abbonamenti non scaduti

In alcuni scenari, potresti trovare utile consentire agli utenti di ripristinare gli abbonamenti non scaduti dal Centro abbonamenti Google Play dopo aver attivato l'annullamento come sviluppatore. Ad esempio, potresti voler fornire un flusso di annullamento in-app personalizzato. In base alla tua logica di business, puoi decidere quali annullamenti attivati dal tuo backend possono essere ripristinati dagli utenti.

Per indicare che un utente può ripristinare l'annullamento, invia una richiesta POST all'API purchases.subscriptions.cancel e imposta il parametro di richiesta cancellationType sul valore USER_REQUESTED_STOP_RENEWALS.

Esempio:

  • Token di acquisto dell'abbonamento 1a2b3c4d5e6f7g8h9i0j
  • Nome pacchetto app com.your.app
  • ID abbonamento your-subscription-product

Richiesta HTTP POST:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel

Corpo della richiesta:

{
  "cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}

Consenti agli utenti di riabbonarsi agli abbonamenti scaduti

Per consentire la riiscrizione a un abbonamento scaduto, devi attivare l'opzione Riabbonati nel piano base dell'abbonamento e poi annullare l'abbonamento impostando il parametro cancellationType sul valore USER_REQUESTED_STOP_RENEWALS.

Consenti agli utenti di abbonarsi di nuovo solo nella tua applicazione

Se hai impostato il parametro cancellationType su DEVELOPER_REQUESTED_STOP_PAYMENTS o non hai impostato il parametro cancellationType, gli utenti non possono ripristinare l'abbonamento dal Centro abbonamenti di Google Play. Tuttavia, se necessario, gli utenti possono registrarsi di nuovo all'abbonamento tramite la tua app.

Questa azione attiva una notifica in tempo reale per lo sviluppatore SUBSCRIPTION_CANCELED. Gestisci questi annullamenti come descritto in Annullamenti.

Posticipa la fatturazione

Puoi estendere il periodo di validità di un abbonamento utilizzando il metodo subscriptionsv2.defer. Quando posticipi un abbonamento con componenti aggiuntivi, tutti gli elementi dell'abbonamento vengono posticipati della stessa durata. Durante il periodo di differimento, l'utente rimane abbonato ai tuoi contenuti, ma non gli viene addebitato alcun costo per il tempo aggiuntivo. Quando posticipi la fatturazione di un abbonamento, le informazioni sullo stato vengono aggiornate di conseguenza e vengono visualizzate nel campo expiryTime nelle informazioni sullo stato dell'acquisto:

  • Per gli abbonamenti ricorrenti attivi, la fatturazione differita estende la data di rinnovo successiva.
  • Per i piani prepagati, la fatturazione differita estende la data di scadenza.

Ecco alcuni esempi di come potresti utilizzare la fatturazione differita:

  • Offri agli utenti l'accesso senza costi come offerta speciale, ad esempio una settimana senza costi agli abbonati esistenti per la compilazione di un modulo di feedback.
  • Offri ai clienti l'accesso senza costi come azione di assistenza clienti, ad esempio dopo un'interruzione prolungata che potrebbe aver influito sulla loro capacità di utilizzare il tuo servizio.

La fatturazione può essere posticipata da un minimo di un giorno a un massimo di un anno per chiamata API. Per posticipare ulteriormente la fine del diritto, chiama nuovamente l'API prima della nuova data di scadenza.

Questa azione attiva una notifica in tempo reale per lo sviluppatore SUBSCRIPTION_DEFERRED. Consulta la sezione Posticipare la fatturazione per un abbonato in Informazioni sugli abbonamenti per scoprire come gestire questi eventi.

Esempio:

  1. Il servizio di streaming FitnessGoals vuole pubblicare una promozione per incoraggiare l'esercizio fisico regolare a febbraio.

  2. Decide di offrire un mese di servizio aggiuntivo a tutti gli abbonati che si allenano con FitnessGoals almeno 10 volte durante il mese di febbraio.

  3. Tiene traccia dei risultati della sfida e, il 1° marzo, chiama il metodo subscriptionsv2.defer per ogni acquisto di abbonamento attivo appartenente agli utenti che hanno completato la sfida a febbraio.

  4. Questi utenti usufruiscono di un mese intero aggiuntivo di video di esercizi regolari senza costi e raccontano a tutti i loro amici come FitnessGoals li aiuta a mantenersi in salute.

Emettere rimborsi e revoche

Esistono molte situazioni in cui potresti voler emettere un rimborso o revocare l'accesso a un abbonamento o a un acquisto una tantum.

Rimborsa completamente un ordine in base all'ID ordine

Con l'API orders.refund, puoi emettere rimborsi totali per qualsiasi ordine entro tre anni dall'acquisto. Il metodo orders.refund riceve un parametro di revoca che indica se l'accesso deve essere revocato o meno, oltre a fornire il rimborso.

Se emetti una revoca con la chiamata di rimborso per l'acquisto di un abbonamento, l'abbonamento viene terminato immediatamente e attiva sia una notifica in tempo reale per lo sviluppatore SUBSCRIPTION_REVOKED sia una VoidedPurchaseNotification (registrata nell'API Voided Purchases). Leggi la sezione Revoche della guida alla gestione del ciclo di vita degli abbonamenti per scoprire come gestire questi eventi.

Esempio:

  1. Per celebrare l'inizio della nuova Coppa del Mondo, l'app di e-sport Football-Not-Soccer decide di mettere in palio maglie virtuali senza costi per tutti gli utenti che acquistano nuovi kit della squadra nelle prime 24 ore.

  2. Football-Not-Soccer utilizza l'API orders.refund senza passare un parametro di revoca per rimborsare gli acquisti delle maglie ai vincitori.

Revoca e rimborsa un abbonamento tramite token di acquisto

Per determinati casi d'uso, potresti dover revocare l'accesso all'abbonamento di un utente e fornire un rimborso. La Fatturazione Play offre metodi di revoca, tra cui rimborsi totali e rimborsi proporzionali tramite l'API subscriptionsv2.revoke. Con questo endpoint, puoi specificare revocationContext per determinare come viene calcolato il rimborso.

Questa azione attiva sia una notifica in tempo reale per gli sviluppatori SUBSCRIPTION_REVOKED sia una notifica VoidedPurchaseNotification e viene registrata nell'API Voided Purchases. La tua app deve gestire questi annullamenti come descritto in Revoche.

Esempio:

  • Acquisto con token di acquisto 1a2b3c4d5e6f7g8h9i0j
  • Applicazione con il nome pacchetto com.your.app
  • Intenzione di emettere un rimborso proporzionale

Richiesta HTTP POST:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke

Corpo della richiesta:

{
  "revocationContext": {
    "proratedRefund": {}
  }
}

Rimborsi totali

Se devi terminare un abbonamento e rimborsare l'intero importo del periodo di fatturazione corrente, emetti un rimborso totale. Utilizza la funzione purchases.subscriptionsv2.revoke e imposta "fullRefund": {} come tipo di rimborso.

Esempio:

  1. Maria ha un abbonamento di 30 giorni con rinnovo automatico al piano mensile di streaming di SuperMovies. Maria ha riscontrato alcuni problemi tecnici che le impediscono di accedere ai contenuti. Contatta l'assistenza clienti il terzo giorno del ciclo di fatturazione, affermando di non aver mai avuto accesso all'abbonamento.

  2. L'assistenza clienti individua i dettagli dell'acquisto dell'abbonamento di Maria nel proprio sistema e attiva una chiamata a purchases.subscriptionsv2.revoke per richiedere un rimborso totale.

  3. L'assistenza clienti comunica a Maria che dovrebbe ricevere il rimborso del 100% del prezzo dell'abbonamento e che non è più abbonata al piano.

Rimborsi proporzionali

Se devi terminare un abbonamento e rimborsare parzialmente il tempo rimanente del diritto, emetti un rimborso proporzionale. Utilizza la funzione purchases.subscriptionsv2.revoke e imposta "proratedRefund": {} come tipo di rimborso.

I rimborsi proporzionali sono supportati sia per gli abbonamenti con rinnovo automatico sia per i piani prepagati con una durata di almeno una settimana.

Esempio:

  1. Maria ha un abbonamento di 30 giorni con rinnovo automatico al piano mensile di streaming di SuperMovies. Utilizza il servizio con soddisfazione da un po' di tempo. Maria contatta l'assistenza clienti il 15° giorno del suo ciclo di fatturazione, dichiarando che si trasferirà all'estero e non potrà più utilizzare il servizio a partire dal giorno successivo.

  2. L'assistenza clienti individua i dettagli dell'acquisto dell'abbonamento di Maria nel proprio sistema e attiva una chiamata a purchases.subscriptionsv2.revoke per richiedere un rimborso proporzionale.

  3. L'assistenza clienti comunica a Maria che dovrebbe ricevere un rimborso di circa il 50% del prezzo dell'abbonamento e che l'accesso al servizio verrà interrotto immediatamente.