API di fatturazione alternativa

Gli sviluppatori idonei possono offrire agli utenti di determinati paesi un sistema di fatturazione alternativo nella propria app e segnalare le transazioni risultanti a Google. A seconda di dove distribuisci la tua app e se la tua app è idonea, sono disponibili due versioni di fatturazione alternativa che un'app può creare:

Questa guida illustra le API che devono essere utilizzate per entrambe le offerte. Ti consigliamo di esaminare le pagine dei programmi e registrarti ai programmi pertinenti prima di utilizzare queste API.

Glossario dei termini

Convenzioni dei termini seguite da questa guida:

  • API di fatturazione alternativa: API utilizzate per mostrare agli utenti eventuali schermate applicabili e consentire agli sviluppatori di segnalare le transazioni completate sul sistema di fatturazione alternativo dello sviluppatore.
  • Sistema di fatturazione alternativo: il sistema di fatturazione alternativo di uno sviluppatore che può essere offerto insieme al sistema di fatturazione di Google Play o singolarmente (soggetto a requisiti di idoneità).
  • Transazione esterna: una transazione che si verifica al di fuori del sistema di fatturazione di Google Play.
  • Token di transazione esterna: un token fornito allo sviluppatore tramite la Libreria Fatturazione Play che lo sviluppatore deve utilizzare quando l'utente completa un sistema di fatturazione alternativo. Questo token viene utilizzato per segnalare a Google Play che l'acquisto è andato a buon fine.
  • ID transazione esterno: un identificatore univoco generato dallo sviluppatore per identificare una transazione.

Offerta della fatturazione alternativa con Scelta dell'utente

Questa sezione descrive come offrire ai tuoi utenti la fatturazione alternativa con la possibilità di utilizzare il sistema di fatturazione di Google Play. Prima di utilizzare queste API, verifica quanto segue:

Gli altri moduli consigliati per l'integrazione di Fatturazione Google Play sono gli stessi che gli sviluppatori avrebbero già per la loro attuale integrazione.

Inoltre, ti consigliamo di avere a portata di mano una configurazione dell'integrazione dell'API Google Play Developer perché l'integrazione del backend la userà.

Configurazione in Play Console

Gli sviluppatori che hanno completato la registrazione al programma di fatturazione alternativa con programma di scelta dell'utente corrispondente e sono integrati con API di fatturazione alternativa possono gestire le proprie impostazioni di fatturazione alternativa tramite Play Console:

  • Per ciascuna delle tue app idonee, puoi scegliere se offrire o meno un sistema di fatturazione alternativo.
  • Carica i loghi dei metodi di pagamento seguendo le linee guida e seguendo tutte le specifiche del formato. Le immagini non conformi a queste linee guida non verranno visualizzate per il tuo sistema di fatturazione alternativo nella schermata di scelta dell'utente. Nota: l'inclusione dei loghi dei metodi di pagamento è facoltativa, ma vivamente consigliata.
  • Se offri abbonamenti, fornisci il link richiesto per la gestione degli abbonamenti.
UI simulata, a scopo illustrativo, soggetta a modifiche.

Esperienza utente

Le API lato client abilitano le seguenti funzionalità:

  • Google Play visualizza e gestisce le informazioni pertinenti e le schermate di scelta dell'utente
  • Se l'utente sceglie di utilizzare il sistema di fatturazione di Google Play, il flusso di fatturazione continua a utilizzare l'interfaccia standard di fatturazione di Google Play.

App sviluppatore.

Schermata Scelta fatturazione.

Esempio solo a scopo illustrativo.

Schermata Scelta dell'utente

La schermata Scelta dell'utente offre agli utenti la possibilità di utilizzare il sistema di fatturazione alternativo dello sviluppatore o il sistema di fatturazione di Google Play.

Struttura di un'opzione di fatturazione alternativa

L'opzione di fatturazione alternativa nella schermata di scelta dell'utente include i seguenti elementi UI:

  1. Icona dell'app.
  2. Nome dell'app.
  3. Asset immagine che include i metodi di pagamento offerti dallo sviluppatore.
  4. Indicatore aggiuntivo (l'elemento UI e altro non fa parte dell'asset immagine).

Asset immagine per i metodi di pagamento

L'asset immagine è composto da più carte di metodi di pagamento e deve seguire le specifiche definite in queste linee guida.

Dimensioni

192 dp x 20 dp

Spaziatura delle schede

8dp

Formato file

PNG, sfondo trasparente

Varianti del metodo di pagamento

Gli sviluppatori possono scegliere il numero massimo di icone disponibili per i metodi di pagamento che vogliono includere nell'asset immagine.

L'immagine non deve includere altre immagini o testo.

Specifiche della carta

Le schede dei metodi di pagamento incluse nell'asset immagine devono seguire le seguenti linee guida per dimensioni, spaziatura e stile.

Dimensioni della scheda 32 dp x 20 dp
Spaziatura interna 3dp
Panoramica 1 dp (corsa interna inclusa nelle dimensioni), Raggio 2 dp, #E0E0E0
Sfondo scheda Colore a tinta unita (preferibilmente bianco)

Passaggi successivi

Per iniziare a integrare le API di fatturazione alternativa con la scelta dell'utente, segui le guide approfondite sia per l'integrazione in-app che per l'integrazione backend.

Offerta solo di fatturazione alternativa

Questa sezione descrive come offrire ai tuoi utenti la fatturazione alternativa senza poter scegliere di utilizzare il sistema di fatturazione di Google Play. Prima di utilizzare queste API, verifica quanto segue:

Ti consigliamo di avere a portata di mano una configurazione dell'integrazione dell'API Google Play Developer perché l'integrazione del backend la userà.

Configurazione in Play Console

Gli sviluppatori che hanno completato la registrazione e sono stati integrati con API di fatturazione alternativa possono gestire le proprie impostazioni di fatturazione alternativa tramite Play Console:

  • Per ciascuna delle app idonee, attiva o disattiva l'offerta di sola fatturazione alternativa (ovvero senza scelta dell'utente) in ogni paese disponibile.
UI simulata, a scopo illustrativo, soggetta a modifiche.

Schermata delle informazioni per gli utenti

La schermata informativa aiuta gli utenti a capire che all'interno dell'app idonea viene offerto un solo sistema di fatturazione alternativo. La schermata informativa verrà mostrata agli utenti all'inizio del loro primo acquisto nella tua app dopo l'attivazione della fatturazione alternativa. Questo messaggio non verrà visualizzato per gli acquisti successivi effettuati dallo stesso utente nella tua app sullo stesso dispositivo. Tieni presente che, in alcuni casi, la finestra di dialogo potrebbe essere mostrata di nuovo a un utente, ad esempio se l'utente svuota le cache sul proprio dispositivo.

Passaggi successivi

Per iniziare a integrare le API di fatturazione alternativa, segui le guide approfondite sia per l'integrazione in-app sia per l'integrazione backend.