Un acquisto in sospeso sembra una vendita, ma il denaro non è arrivato, e concederlo troppo presto regala il prodotto

Qualcuno tocca acquista nella tua app. I tuoi log mostrano un nuovo ordine, il tuo listener di fatturazione scatta, e consegni la merce. Sulla maggior parte degli acquisti è esattamente giusto. Su un acquisto in sospeso è un errore, perché l'ordine esiste ma il denaro no. Il cliente ha scelto un metodo di pagamento che si regola più tardi, lo store aspetta ancora di essere pagato, e hai appena consegnato una funzione a pagamento per un addebito che potrebbe non andare mai a buon fine. Questo è il cugino silenzioso di un rimborso. Qui non viene annullato nulla, perché non è mai stato incassato nulla. Hai semplicemente regalato il prodotto.

Un acquisto in sospeso è un ordine reale in uno stato non ancora pagato, e sia l'App Store sia Google Play ne hanno uno. Entrambi gli store ti dicono chiaramente di aspettare. La trappola è che un ordine in sospeso sembra quasi identico a uno completato nel tuo codice, così un'integrazione che tratta ogni nuovo acquisto come una vendita spedisce merce su ordini che lo store sta ancora cercando di incassare. Gestiscilo correttamente e non perdi nulla. Gestiscilo male e ogni pagamento lento che salta è puro costo, consegnato a tue spese.

Cos'è davvero un acquisto in sospeso

Un acquisto in sospeso è un ordine che lo store ha registrato ma non ancora addebitato. L'acquirente ha avviato il flusso, lo store lo ha accettato, e la regolazione avviene da qualche parte che la tua app non può vedere. Google Play chiama questo lo stato PENDING. Apple lo chiama una transazione in sospeso, o differita. Nomi diversi, stesso fatto: lo store tiene aperto un ordine mentre aspetta di essere pagato, e ti ha detto di non trattare quell'ordine come denaro.

Google Play: il pagamento avviene altrove

Alcuni metodi di pagamento si regolano fuori banda. I contanti in un negozio fisico, i bonifici bancari e parte dell'addebito tramite operatore richiedono passaggi aggiuntivi tra il tocco e l'addebito. Quando un cliente ne sceglie uno, Google restituisce l'acquisto nello stato PENDING invece di PURCHASED. Per un pagamento in contanti, il cliente riceve un codice tramite notifica ed e-mail, lo porta in un negozio aderente e paga alla cassa. Fino a quel momento, Google non ha incassato nulla, e nemmeno tu. La regola di Google è una riga: usa getPurchaseState() e concedi il diritto solo quando lo stato è PURCHASED. Ti dice anche di non confermare un acquisto finché è in PENDING, perché la conferma appartiene a un ordine pagato, non a uno promesso.

Apple: l'acquisto aspetta il tocco di qualcun altro

Lo stato in sospeso di Apple significa che la transazione ha bisogno di un'azione esterna prima di potersi completare. La più comune è Ask to Buy, dove un bambino avvia un acquisto e un organizzatore della famiglia deve approvarlo. In StoreKit 2, la chiamata di acquisto restituisce Product.PurchaseResult.pending. Nel vecchio StoreKit, la transazione viene segnalata come differita. In ogni caso, Apple non ha addebitato nessuno, e la transazione finita, se arriva, arriva in modo asincrono tramite Transaction.updates. Mostra al cliente uno stato di attesa e non sbloccare nulla finché la transazione completata non atterra.

Perché concedere un acquisto in sospeso ti costa denaro vero

La perdita qui non è del tipo rimborso, dove il denaro che avevi contabilizzato viene ritirato. È peggio sotto un aspetto specifico: non c'è denaro da ritirare, perché non ne è mai stato incassato.

Tu consegni, e lo store non incassa mai

Quando sblocchi su un ordine in sospeso che poi si annulla, hai già speso per servirlo. L'elaborazione che ha eseguito la funzione, le chiamate API di terze parti che hai pagato, lo spazio di archiviazione che hai allocato e, per un consumabile, l'effettivo esborso della cosa che hai venduto. Tutto questo esce dalla porta su un ordine che non ha prodotto ricavi. Un rimborso parte almeno da un addebito che è avvenuto. Un acquisto in sospeso concesso per errore non ha mai avuto alcun addebito, quindi non compare nemmeno come denaro in uscita. Compare come nulla, che è esattamente il motivo per cui è facile da non notare e facile da ripetere.

Il segnale di annullamento, e cosa significa

Lo store ti avvisa eccome quando un ordine in sospeso muore. Su Google Play, un prodotto singolo che salta invia una notifica ONE_TIME_PRODUCT_CANCELED, tipo 2, e un abbonamento che era in sospeso invia SUBSCRIPTION_PENDING_PURCHASE_CANCELED, tipo 20. Quando gli stessi ordini invece vanno a buon fine, ricevi ONE_TIME_PRODUCT_PURCHASED, tipo 1, o SUBSCRIPTION_PURCHASED, tipo 4. Su Apple non c'è un evento di annullamento da intercettare, perché una transazione differita che viene rifiutata semplicemente non diventa mai una transazione completata. Se hai sbloccato troppo presto, quel silenzio è il conto.

La finestra, e chi aspetta chi

Un acquisto in sospeso non è un cronometro contro cui corri. È un cronometro che, dal tuo lato, non è partito.

Google Play dà al cliente giorni, non minuti

Un pagamento in contanti o tramite bonifico si regola secondo i tempi del cliente, non i tuoi. L'ordine resta in PENDING finché il cliente non paga o la finestra scade e Google lo annulla. La tua finestra di conferma di tre giorni, quella che rimborsa automaticamente un acquisto che non confermi, non inizia nemmeno finché l'acquisto non passa da PENDING a PURCHASED. Quindi non c'è fretta di servire un ordine in sospeso. C'è solo la disciplina di aspettare che lo stato cambi.

L'approvazione di Apple è sul telefono dell'organizzatore della famiglia

Una richiesta Ask to Buy arriva sul dispositivo dell'organizzatore come un avviso che approva o rifiuta quando ci arriva. Possono essere minuti, ore o un giorno dopo, e la tua app non può fare fretta. L'unico comportamento corretto è riflettere lo stato di attesa e lasciare che StoreKit ti consegni la transazione completata se e quando arriva l'approvazione.

Come gestire gli acquisti in sospeso senza perdite

Tutto il lavoro si riduce a quattro abitudini. Nessuna è difficile, e saltarne anche solo una è da dove se ne va il denaro.

Concedi sullo stato pagato, mai su quello in sospeso

Su Google Play, controlla getPurchaseState() e concedi solo su PURCHASED, e non confermare un acquisto finché è in PENDING. Su Apple, sblocca solo su una transazione completata e mai sul risultato in sospeso. Questa singola regola chiude l'intera perdita. Tutto il resto riguarda l'assicurarti di accorgerti davvero quando arriva lo stato pagato.

Ricontrolla quando l'app torna in primo piano

Il passaggio da in sospeso a pagato spesso avviene mentre la tua app non è in esecuzione. Su Google Play, chiama queryPurchasesAsync() nel tuo handler onResume() per raccogliere gli ordini diventati PURCHASED in background, e mantieni il tuo listener di Real-time Developer Notifications come fonte di verità lato server. Su Apple, ascolta Transaction.updates per tutta la vita dell'app, perché una transazione approvata può arrivare molto dopo che la chiamata di acquisto originale è tornata.

Abilita il supporto agli acquisti in sospeso e testa entrambi gli esiti

Google richiede di chiamare enablePendingPurchases() quando costruisci il BillingClient, e supportare le transazioni in sospeso per i prodotti singoli è obbligatorio, non facoltativo. Testalo prima di pubblicare. I tester con licenza ottengono due strumenti di test aggiuntivi per le forme di pagamento differito, dove il pagamento si completa automaticamente o si annulla automaticamente dopo un paio di minuti, così puoi osservare da capo a fondo sia il percorso del pagamento sia quello del fallimento.

Di' al cliente che l'ordine non è concluso

Un acquirente in sospeso è un cliente reale nel mezzo di un acquisto, non un fallimento. Mostragli che l'ordine aspetta il suo pagamento o un'approvazione, e dagli una via chiara per tornare a completarlo. Uno stato in sospeso silenzioso perde vendite che uno ben etichettato recupera, perché la maggior parte di questi acquirenti vuole ancora la cosa e ha solo un passo rimasto.

Gli stessi feed di Real-time Developer Notifications e App Store Server Notifications che RefundHalt legge già per rimborsi e storni portano anche questi segnali. La notifica di acquisto che dice che un ordine in sospeso è finalmente andato a buon fine, e quella di annullamento che dice di no, atterrano nella tua dashboard accanto al resto dei tuoi eventi di ricavo, così un ordine in sospeso che è saltato è qualcosa che puoi vedere invece di qualcosa che hai pagato per sbaglio.

La versione breve

Un acquisto in sospeso è un ordine senza pagamento, ed entrambi gli store sono espliciti sul fatto che dovresti aspettare. Google Play restituisce gli ordini in contanti, tramite bonifico e parte dell'addebito tramite operatore in uno stato PENDING e ti dice di concedere l'accesso solo su PURCHASED. Apple restituisce una transazione in sospeso o differita per Ask to Buy e altre azioni richieste e consegna la transazione completata più tardi tramite Transaction.updates. Sblocca sullo stato pagato, ricontrolla quando la tua app riprende, abilita e testa il supporto agli acquisti in sospeso, ed etichetta l'ordine in attesa per il cliente. Fai questo e un acquisto in sospeso non ti costa nulla. Saltalo e consegni un prodotto a pagamento per un addebito che non è mai arrivato, che è l'unica perdita senza una ricevuta da indicare.