Revisione ed elenco delle app

Gli stati di un'app#

Invio in revisione#

1. 1

   Completa la lista di controllo

   Puoi inviare l'app solo quando hai completato tutto: nome (da 2 a 60 caratteri), logo, descrizione, sito web, indirizzo dell'informativa privacy, e-mail di supporto, almeno un URI di reindirizzamento valido (un indirizzo https per un'app riservata), un collegamento al tuo locale di prova, almeno una richiesta con stato 2xx negli ultimi 14 giorni e, se la tua app ha un webhook, almeno una consegna riuscita negli ultimi 30 giorni.

   Console › App › Revisione

2. 2

   Invia in revisione

   Lo stato passa a «In revisione». In questo periodo l'app non si può modificare. Finché Flavoso non ha deciso, «Ritira l'invio» la riporta in sviluppo.

   Console › App › Revisione

3. 3

   Attendi la decisione

   Di solito servono pochi giorni lavorativi. La decisione arriva via e-mail, e un rifiuto è sempre motivato. In quel caso modifichi l'app e la invii di nuovo.

Cosa viene verificato#

• I dati sono completi e gli indirizzi raggiungibili.
• Nome e logo non ingannano: nessun marchio altrui, nessuna impressione che l'app sia di Flavoso.
• L'app richiede solo i permessi di cui ha bisogno per il suo scopo.

Lista di controllo prima dell'invio#

• Hai provato l'intero flusso con il locale di prova: collegamento, ordini, menu, casi di errore, scollegamento.
• I token sono salvati cifrati sul tuo server, il client secret mai in un'app o nel browser.
• Per ogni collegamento il token di aggiornamento viene rinnovato in un solo punto, e si salva sempre quello nuovo.
• Le firme dei webhook vengono verificate, i duplicati riconosciuti dall'id.
• Ogni POST include un Idempotency-Key; dopo 429 e 5xx si riprova con intervalli crescenti.
• livemode: false non finisce mai nei dati reali.
• app.disconnected e invalid_grant nel rinnovo portano a un messaggio chiaro con «Ricollega»; unauthorized_client mostra «bloccata temporaneamente» e conserva i token.
• Il tuo software mostra a quale locale è collegato e può scollegarsi (DELETE /connection).
• Le e-mail all'indirizzo di supporto vengono lette.

Dopo l'approvazione#

Una volta approvata la tua app, ogni titolare può collegarla, e la schermata di consenso mostra «Verificata da Flavoso».

• Valgono subito: le modifiche a descrizione ed e-mail di supporto, e un URI di reindirizzamento eliminato.
• Attendono una nuova revisione: nome, logo, sito web, indirizzo dell'informativa privacy, nuovi URI di reindirizzamento, permessi aggiuntivi e nuovi dati nell'elenco delle app (categoria, slogan, indirizzo di installazione). Fino ad allora vale la versione verificata.

L'elenco delle app#

Ogni app approvata compare nell'elenco delle app, dove i locali la trovano: nella dashboard in Impostazioni › Integrazioni, e pubblicamente su flavoso.com/<lingua>/integrations. Così un locale vede con cosa può collegarsi. La scheda la gestisci nelle impostazioni della tua app, e fa parte della checklist prima dell'invio:

Nell'elenco compaiono solo app approvate, e ci compaiono tutte. Un'app approvata non si può togliere dall'elenco; se non vuoi più offrirla, eliminala. Se un'app viene bloccata, la sua scheda sparisce.

Il marchio Flavoso#

• Scrivi Flavoso così: una parola, F maiuscola. Non usarlo nel nome della tua app in modo che sembri un prodotto di Flavoso («Flavoso Cassa»); «Cassa X per Flavoso» va bene.
• Il logo di Flavoso non è l'icona della tua app.
• «Verificata da Flavoso» lo mostra solo Flavoso, nella schermata di consenso e nell'elenco. Non dichiarare partnership, certificazioni o raccomandazioni che non esistono.
• Il pulsante si chiama «Collega con Flavoso» (per le altre lingue vedi Autenticazione).

Blocco#

In caso di violazione delle condizioni per sviluppatori o di abuso, Flavoso può bloccare un'app. Da quel momento i suoi token vengono rifiutati con 401, le consegne vengono saltate e nessuno può collegarla di nuovo. I suoi collegamenti restano: quando Flavoso toglie il blocco, tutto riprende.

In quel periodo l'endpoint del token risponde a un rinnovo con 400 unauthorized_client, non con invalid_grant. Conserva i token, mostra «bloccata temporaneamente» e riprova più tardi. Possono mancare eventi del periodo del blocco, anche in GET /events, senza che gap lo segnali. Quando il blocco termina, riconcilia quindi tramite gli elenchi, per esempio con GET /orders?updated_since=….

Eliminare un'app#

Puoi eliminare la tua app nelle sue impostazioni. Così terminano tutti i suoi collegamenti e nessun token dell'app è più valido. L'operazione è irreversibile; per ricominciare devi creare una nuova app.