Permissions

Le catalogue des permissions d’une clé et comment accorder le strict nécessaire.

Une clé n’a que les permissions que vous lui donnez. Chaque endpoint en exige une seule, indiquée dans la référence. Sans elle, la réponse est 403 missing_scope et le champ errors.scopes nomme la permission manquante.

Une permission .write inclut automatiquement la lecture correspondante : products.write permet aussi de lister les produits. L’inverse n’est jamais vrai.

Permission	Ce qu’elle permet
store.read	Lire le nom, le logo et l’adresse de la boutique liée.
products.read	Lister et consulter les produits.
products.write	Créer, modifier, publier, dépublier, archiver et supprimer des produits.
sales.read	Lister et consulter les commandes.
sales.write	Marquer une commande livrée ou annuler une commande impayée.
customers.read	Lister et consulter les clients (acheteurs).
discounts.read	Lister et consulter les codes promo.
discounts.write	Créer, modifier et supprimer des codes promo.
licenses.read	Lister et consulter les licences, valider une clé, lire les activations.
licenses.write	Activer, désactiver et révoquer des licences.
affiliates.read	Lister les affiliés, vérifier un code de parrainage, lire les commissions.
pulses.read	Lister les Pulses et leur historique d’envoi.
pulses.write	Créer, modifier, supprimer et tester des Pulses.
checkout.write	Créer un lien de paiement pour un produit.

Recommandations

Une clé par usage

Une clé pour votre serveur de licences, une autre pour Zapier. Si l’une fuit, vous ne révoquez que celle-là.

Lecture seule par défaut

Un tableau de bord ou un export n’a besoin que des permissions .read.

Valider une licence, rien de plus

POST /licenses/validate ne demande que licenses.read : votre logiciel peut vérifier une clé sans pouvoir en révoquer.

Aucun remboursement par API

Le remboursement est un mouvement d’argent : il reste dans le tableau de bord, quelle que soit la clé.