Un rimborso di Family Sharing annulla un solo pagamento ma può lasciare altre cinque persone a usare ancora la tua app, e solo il tuo server può escluderle

Un solo acquisto in un gruppo Family Sharing può consegnare la tua app a sei persone. Chi ha pagato è una di loro. Le altre cinque non hanno mai aperto il portafoglio, e Apple si aspetta comunque che la tua app funzioni per tutte. Questo è il patto che accetti nel momento in cui attivi Family Sharing per un acquisto in-app. È anche il motivo per cui un rimborso di Family Sharing è una bestia diversa da uno ordinario. Quando l'acquirente riottiene i suoi soldi, la vendita si annulla per un account, ma l'accesso che hai concesso ad altre cinque persone al massimo non si spegne da solo. Deve farlo il tuo server, e se è stato scritto per sorvegliare solo l'acquirente, non lo farà.

Ecco il quadro completo in un unico posto. Questo articolo ripercorre come Apple contrassegna un acquisto condiviso, l'unico campo che distingue l'acquirente dalla famiglia, esattamente quando Apple ti invia un REVOKE e come leggerlo, il dettaglio silenzioso che separa un rimborso da qualcuno che semplicemente lascia la famiglia, e quanto costa davvero un rimborso condiviso una volta che conti il calcolo che hai già speso per persone che non ti hanno mai pagato.

Cosa distribuisce Family Sharing, e a quante persone

Attiva Family Sharing per un prodotto e cambi chi è il tuo cliente pagante. Un gruppo famiglia su Apple può contenere fino a sei persone, un organizzatore e fino a cinque membri. Quando chiunque nel gruppo compra un prodotto condivisibile in famiglia, tutti nel gruppo ottengono l'accesso. Non pagano. Non compaiono nel tuo fatturato. Compaiono semplicemente nella tua app con un diritto valido, perché Apple emette a ciascuno di loro una transazione che punta allo stesso acquisto.

Solo due tipi di prodotto sono condivisibili, e i consumabili non sono tra questi

Family Sharing copre esattamente due tipi di acquisto in-app: non consumabili e abbonamenti a rinnovo automatico. I consumabili, i prodotti a monete e crediti, non vengono mai condivisi, ed è per questo che un membro della famiglia non attiva mai un CONSUMPTION_REQUEST né compare nella tua rendicontazione dei consumi. Se la tua app vende solo consumabili, i rimborsi di Family Sharing non sono un tuo problema. Se vendi uno sblocco a vita o un piano ricorrente, lo sono.

Il campo che distingue un acquirente da un beneficiario

Ogni transazione che Apple emette porta un inAppOwnershipType. Ha due valori. PURCHASED significa che questo account ha pagato il prodotto e può gestirlo, incluso annullarlo o richiederne il rimborso. FAMILY_SHARED significa che questo account è un membro della famiglia che ha accesso tramite l'acquisto di qualcun altro. Entrambi danno diritto alla persona di usare il tuo prodotto. Solo uno di loro ha pagato. Il campo è sulla transazione StoreKit, sulla ricevuta e sull'App Store Server API, quindi puoi leggerlo ovunque tu controlli già i diritti.

Come un rimborso di Family Sharing raggiunge il tuo server

Un rimborso su un acquisto condiviso inizia nello stesso modo di qualsiasi rimborso Apple. L'acquirente, l'unica persona che può, chiede ad Apple i suoi soldi indietro. Apple decide. Se Apple lo concede, l'acquisto dell'acquirente viene annullato e Apple invia al tuo server un App Store Server Notification REVOKE. Sia la V1 sia la V2 della notifica lo trasportano. Il REVOKE è il tuo unico segnale che il diritto che vi sta dietro, e ogni sua copia condivisa in famiglia, è ora nullo.

Non revocare una transazione, rileggi l'intera cronologia

L'indicazione di Apple su un REVOKE è netta: non trattarlo come un singolo interruttore. Quando ne ricevi uno, percorri l'intera cronologia delle transazioni del cliente e ricostruisci i suoi diritti da zero, perché una persona può avere più di una transazione che concede lo stesso prodotto o uno diverso. Revoca solo la transazione nominata nella notifica e puoi lasciare un membro della famiglia rimborsato con l'accesso attivo, oppure escludere qualcuno che ha ancora un secondo diritto valido. Ristabilisci il quadro completo ogni volta.

L'unico dettaglio che separa un rimborso da una rottura familiare

Ecco la trappola che costa a un team un pomeriggio di debugging. Un REVOKE può significare due cose molto diverse per una transazione FAMILY_SHARED, e il modo per distinguerle è un campo che a volte è semplicemente assente. Quando l'acquirente ottiene un rimborso, la transazione FAMILY_SHARED arriva con un revocationDate. Quando un membro della famiglia semplicemente lascia il gruppo, lo stesso tipo di REVOKE arriva senza alcun revocationDate. Gli ingegneri del commercio di Apple lo hanno detto direttamente sui forum per sviluppatori. In entrambi i casi togli l'accesso, ma solo quello con la data è un rimborso, e solo il rimborso è quello che ha anche annullato un pagamento.

Quanto ti costa davvero un rimborso condiviso

Segui il denaro, perché è qui che Family Sharing cambia silenziosamente i conti. Un rimborso normale annulla una vendita. Apple restituisce il prezzo all'acquirente e ridà la sua commissione, quindi il lato store va quasi in pari. Ciò che non torna mai è quanto hai già speso per erogare il prodotto. Con Family Sharing, non l'hai speso una volta sola. L'hai speso per un massimo di sei persone. L'acquirente e fino a cinque membri della famiglia hanno ciascuno fatto girare il tuo calcolo, chiamato le tue API, riempito il tuo storage e prelevato qualsiasi pagamento tu finanzi, tutto sulla forza di un solo pagamento.

Ora l'acquirente chiede il rimborso. L'unico pagamento si annulla. L'accesso di ogni membro della famiglia dovrebbe terminare nello stesso momento, perché la cosa che giustificava il servirli, un solo acquisto pagato, non c'è più. Se il tuo server revoca solo la transazione PURCHASED e lascia attive quelle FAMILY_SHARED, fino a cinque persone tengono le tue funzioni a pagamento gratis, e tu continui a pagare per servirle, senza più nulla nel sistema su cui fatturare. Non è un errore di arrotondamento. È cinque volte il costo di erogazione della vendita che hai appena restituito.

Gli abbonamenti rendono la falla ricorrente

Per un non consumabile, un membro della famiglia non revocato è una perdita una tantum che dura finché non te ne accorgi. Per un abbonamento a rinnovo automatico è peggio, perché il diritto era già ricorrente. Un rimborso sull'ordine dell'abbonamento dovrebbe terminare la condivisione per l'intero gruppo, ma un membro della famiglia lasciato attivo mantiene il livello a pagamento a ogni periodo di fatturazione in cui non lo chiudi. La soluzione è la stessa, ristabilire i diritti dall'intera cronologia a ogni REVOKE, ma il costo di saltarla si accumula.

Farlo bene, e testarlo prima che lo faccia un rimborso vero

Non c'è nulla di esotico da costruire qui. L'intero lavoro è ancorare l'accesso al diritto, non all'acquirente, e ricostruire quell'accesso a ogni REVOKE.

• Memorizza l'accesso rispetto alla transazione e al suo inAppOwnershipType, non rispetto a un singolo account acquirente, così che una transazione FAMILY_SHARED conceda l'accesso da sola e possa essere revocata da sola.
• Su qualsiasi notifica REVOKE, rileggi l'intera cronologia delle transazioni del cliente e ricalcola i diritti, invece di spegnere l'unica transazione nominata.
• Tratta una transazione FAMILY_SHARED con un revocationDate come un rimborso e termina l'accesso di quel membro. Tratta una senza revocationDate come un'uscita dalla famiglia e terminala comunque.
• Non affrettare un acquisto condiviso appena effettuato in servizio. Apple lo trattiene per circa un'ora così che l'acquirente possa tirarsi indietro, quindi rispetta la transazione che Apple emette davvero invece di concedere al tocco d'acquisto.
• Fai le prove. Lo strumento Testing Family Sharing di Apple ti permette di simulare una transazione condivisa, e un rimborso in sandbox scatena lo stesso REVOKE che riceverà il tuo server di produzione.

Fai questo e un rimborso di Family Sharing diventa un non evento. L'acquirente riottiene i suoi soldi, l'intero gruppo perde l'accesso nello stesso battito, e tu smetti di pagare per servire persone che non ti stavano mai pagando.