Règles de vérification

Chaque application démarre en mode test : vous seul pouvez l'installer, sur les boutiques dont vous êtes propriétaire. Avant qu'un autre marchand puisse l'installer, DZBuild la vérifie. Cette page liste les statuts d'une application, ce que la console exige avant l'envoi et ce que le vérificateur contrôle.

Statuts d'une application

Statut	Signification	Qui peut l'installer	Installations existantes
draft	Nouvelle application. Tout est modifiable.	Vous seul, sur vos boutiques.	Les appels depuis vos boutiques fonctionnent.
in_review	Envoyée et en attente de décision. La console affiche la date d'envoi. La modification est bloquée.	Vous seul, sur vos boutiques.	Les appels depuis vos boutiques fonctionnent. Si l'application était déjà approuvée, chaque installation existante continue de fonctionner.
approved, répertoriée	Affichée à toutes les boutiques sur la page Extensions.	Tout propriétaire de boutique dont le plan atteint le plan minimum de l'application.	Fonctionnent normalement.
approved, non répertoriée	Fonctionne comme une application répertoriée, mais la page Extensions ne l'affiche qu'aux boutiques qui l'ont installée.	Tout propriétaire de boutique dont le plan atteint le plan minimum de l'application, via votre propre lien d'installation.	Fonctionnent normalement.
rejected	DZBuild a envoyé les raisons par e-mail. Vous pouvez modifier puis renvoyer.	Personne, vous compris.	Chaque appel reçoit 403 app_suspended.
suspended	DZBuild a arrêté l'application. La modification est bloquée.	Personne.	Chaque appel reçoit 403 app_suspended. Le marchand ne peut pas ouvrir l'application.

Vous pouvez renouveler le client secret et le secret de signature quel que soit le statut.

Avant l'envoi

Le bouton d'envoi de la console refuse l'application avec la liste de ce qui manque tant que tous ces éléments ne sont pas en place :

• un logo PNG, JPEG ou WebP, de 1 Mo au plus et d'au moins 128 sur 128 pixels ;
• une description en anglais, en arabe et en français, chacune d'au moins 20 caractères (500 au plus) ;
• au moins une adresse de redirection ;
• un lien d'ouverture en https ;
• une adresse e-mail de support ;
• au moins un scope ;
• une URL de webhook vérifiée, si vous en avez défini une ;
• au moins une installation de l'application sur une de vos boutiques.

Cliquez sur un élément de la liste des manques pour aller à son champ.

La console applique aussi ces règles à l'enregistrement :

• Le nom de l'application compte 3 à 60 caractères et ne doit pas contenir « dzbuild ».
• Le nom du développeur compte 2 à 80 caractères.
• Jusqu'à 5 adresses de redirection, en https uniquement.
• Changer l'URL de webhook efface sa vérification : vérifiez-la de nouveau.
• Un compte DZBuild peut enregistrer jusqu'à 10 applications.

Ce que DZBuild vérifie

Le vérificateur voit tout votre enregistrement et votre compte développeur. La vérification couvre :

• La fiche. Nom, nom du développeur, logo, page d'accueil, e-mail de support et les trois descriptions. Les marchands lisent ces descriptions avant d'installer : chacune doit dire ce que l'application fait des données de la boutique.
• Les adresses de redirection. Chaque adresse est listée, et une adresse dont l'hôte diffère de celui de votre page d'accueil est signalée. Utilisez votre propre domaine pour les deux.
• Les scopes. Regroupés en lecture et écriture par ressource, et comparés à ce que les descriptions disent de l'application. Voir scopes.
• L'URL de webhook. Contrôlée de nouveau selon les règles d'URL de la plateforme, avec l'état de vérification de votre installation de test.
• Votre compte. Votre identité, l'historique de votre compte et vos autres applications.
• Les installations de test. Les boutiques où l'application est installée.
• Les règles de sécurité. Adresses de redirection, secrets, contrôle des signatures, suppression des données, extraction automatisée et support, comme sur la page sécurité.

Décisions

DZBuild répond à chaque envoi par e-mail : en français quand la langue de votre compte DZBuild est le français, en arabe sinon.

• Approuvée. L'application devient disponible pour tout marchand dont le plan atteint son plan minimum, répertoriée ou non comme l'explique la section suivante.
• Refusée. L'e-mail contient les notes du vérificateur. Corrigez les points puis renvoyez l'application depuis la console.
• Suspendue. Une application approuvée peut être suspendue, avec une note qui en donne la raison. Ses appels à l'API sont refusés dès la requête suivante. Répondez à l'e-mail pour en parler. Quand la suspension est levée, l'application redevient approuvée et les appels fonctionnent.

Répertoriée ou non répertoriée

DZBuild décide si une application approuvée est répertoriée ou non. Vous ne le choisissez pas à l'envoi.

• Répertoriée. L'application apparaît sur la page Extensions de toutes les boutiques.
• Non répertoriée. L'application fonctionne comme une application répertoriée : même écran de consentement, mêmes jetons, même API et mêmes webhooks. Elle n'apparaît pas sur la page Extensions : le marchand l'installe donc via votre propre lien d'installation, une page de votre site qui ouvre l'URL d'autorisation. Une fois installée, l'application s'affiche sur la page Extensions de cette boutique.

Les deux passent la même vérification. La console indique quand votre application est non répertoriée, et l'e-mail d'approbation le précise. DZBuild peut ensuite passer une application approuvée de répertoriée à non répertoriée, ou l'inverse, sans nouvel envoi. Les installations existantes continuent de fonctionner après le changement.

Modifier une application approuvée

Enregistrer une modification d'une application approuvée, logo compris, la renvoie en in_review après votre confirmation. Les boutiques qui l'ont déjà installée continuent de fonctionner pendant l'attente ; les autres marchands ne peuvent pas l'installer tant que DZBuild n'a pas approuvé la modification. Regroupez vos changements en un seul enregistrement. Renouveler un secret ou vérifier l'URL de webhook ne lance pas de vérification.