Validation et annuaire

Les statuts d'une application#

Soumettre#

1. 1

   Compléter la liste de contrôle

   Vous ne pouvez soumettre l'application qu'une fois tous les points remplis : nom (2 à 60 caractères), logo, description, site web, adresse de la politique de confidentialité, e-mail de support, au moins une URI de redirection valide (une adresse https pour une application confidentielle), une connexion à votre établissement de test, au moins une requête avec un statut 2xx ces 14 derniers jours et, si votre application a un webhook, au moins une livraison réussie ces 30 derniers jours.

   Console › Application › Validation

2. 2

   Soumettre à validation

   Le statut passe à « En cours d'examen ». Pendant l'examen, l'application ne peut pas être modifiée. Tant que Flavoso n'a pas rendu sa décision, « Retirer la soumission » la remet en développement.

   Console › Application › Validation

3. 3

   Attendre la décision

   En général quelques jours ouvrés. La décision arrive par e-mail ; un refus est accompagné d'un motif. Modifiez alors l'application et soumettez-la à nouveau.

Ce qui est vérifié#

• Les informations sont complètes et les adresses accessibles.
• Le nom et le logo ne sont pas trompeurs : pas de marque d'autrui, rien qui laisse croire que l'application vient de Flavoso.
• L'application ne demande que les droits dont elle a besoin pour fonctionner.

Liste de contrôle avant la soumission#

• Tout le parcours a été testé de bout en bout avec l'établissement de test : connexion, commandes, carte, cas d'erreur, déconnexion.
• Les jetons sont enregistrés chiffrés sur votre serveur, le client secret jamais dans une application ni dans un navigateur.
• Le rafraîchissement se fait à un seul endroit par connexion, et c'est toujours le nouveau jeton de rafraîchissement qui est enregistré.
• Les signatures des webhooks sont vérifiées, les doublons repérés par id.
• Chaque POST porte une Idempotency-Key ; les 429 et les 5xx sont réessayés en espaçant les tentatives.
• livemode: false ne se retrouve jamais dans des données réelles.
• app.disconnected et un invalid_grant au rafraîchissement donnent lieu à un message clair avec « Reconnecter » ; unauthorized_client affiche « temporairement bloquée » et conserve les jetons.
• Votre logiciel indique à quel établissement il est connecté et peut se déconnecter (DELETE /connection).
• Les messages envoyés à l'adresse de support sont lus.

Après la validation#

Dès la validation, tout propriétaire peut connecter votre application, et l'écran de consentement affiche « Vérifiée par Flavoso ».

• S'appliquent immédiatement : les modifications de la description et de l'e-mail de support, ainsi que la suppression d'une URI de redirection.
• Soumis à un nouvel examen : le nom, le logo, le site web, l'adresse de la politique de confidentialité, les nouvelles URI de redirection, les droits supplémentaires et les nouvelles informations de l'annuaire (catégorie, accroche, adresse d'installation). D'ici là, c'est la version validée qui s'applique.

L'annuaire des applications#

Chaque application validée figure dans l'annuaire des applications, où les établissements la trouvent : dans le tableau de bord sous Réglages, Intégrations, et publiquement à l'adresse flavoso.com/<langue>/integrations. Un établissement voit ainsi à quoi il peut se connecter. Vous gérez la fiche dans les réglages de votre application, et elle fait partie de la liste de contrôle avant la soumission :

Seules les applications validées figurent dans l'annuaire, et toutes y figurent. Une application validée ne peut pas être retirée de l'annuaire ; si vous ne souhaitez plus la proposer, supprimez-la. Si une application est bloquée, sa fiche disparaît.

La marque Flavoso#

• Écrivez Flavoso ainsi : en un seul mot, avec un F majuscule. N'utilisez pas Flavoso dans le nom de votre application d'une manière qui laisse croire à un produit Flavoso (« Flavoso Caisse ») ; « Caisse X pour Flavoso » convient.
• Le logo Flavoso ne doit pas servir d'icône à votre application.
• Seul Flavoso affiche « Vérifiée par Flavoso », sur l'écran de consentement et dans l'annuaire. N'affirmez aucun partenariat, aucune certification ni aucune recommandation qui n'existe pas.
• Le bouton s'intitule « Connecter avec Flavoso » (pour les autres langues, voir Authentification).

Blocage#

En cas de violation des conditions pour les développeurs ou d'abus, Flavoso peut bloquer une application. Ses jetons sont alors refusés avec 401, les livraisons ignorées, et personne ne peut la connecter à nouveau. Les connexions subsistent : quand Flavoso lève le blocage, tout reprend.

Pendant ce temps, le point de terminaison des jetons répond à un rafraîchissement par 400 unauthorized_client, et non par invalid_grant. Conservez les jetons, affichez « temporairement bloquée » et réessayez plus tard. Des événements de la période de blocage peuvent manquer, y compris dans GET /events, sans que gap le signale. Après la levée du blocage, rapprochez donc les données au moyen des listes, par exemple avec GET /orders?updated_since=….

Supprimer une application#

Vous supprimez votre application dans ses réglages. Toutes ses connexions prennent alors fin et plus aucun jeton de l'application ne fonctionne. C'est irréversible ; pour repartir de zéro, créez une nouvelle application.