Référence des permissions

Les Stripe Apps utilisent un système de permissions pour contrôler l’accès aux ressources de l’API Stripe. Chaque permission doit être explicitement déclarée dans le manifest de votre app avec un énoncé de but clair.

Gestion des permissions

{
"permissions": [
{
"permission": "customer_read",
"purpose": "Read customer profiles to sync with Brevo contacts"
},
{
"permission": "customer_write",
"purpose": "Update customer metadata with Brevo sync status"
}
]
}

Bonnes pratiques

  • Minimum nécessaire : Ne demandez que les permissions que votre app utilise réellement
  • Buts clairs : Rédigez des descriptions compréhensibles par des utilisateurs non techniques
  • Justifiez lecture+écriture : Si vous avez besoin des deux, expliquez pourquoi
  • Révision régulière : Supprimez les permissions non utilisées lors des mises à jour

Tip

Demander des permissions excessives est l’une des raisons les plus courantes de rejet d’app.

Permissions par produit

Core

RessourcePermissionDescription
Compteaccount_readLire les détails et paramètres du compte
Clientcustomer_readLire les profils clients et méthodes de paiement
Clientcustomer_writeCréer, mettre à jour ou supprimer des clients
Événementevent_readLire et s’abonner aux événements
Produitproduct_readLire le catalogue produits et les prix

Paiements

RessourcePermissionDescription
Fraischarge_readLire les charges et remboursements
Intent de paiementpayment_intent_readLire les détails des intents de paiement

Facturation

RessourcePermissionDescription
Factureinvoice_readLire les détails de facture
Abonnementsubscription_readLire les détails d’abonnement

Secret Store

RessourcePermissionDescription
Secretsecret_readLire les secrets du Secret Store
Secretsecret_writeCréer, mettre à jour ou supprimer des secrets

Caution

Lors de la demande de permissions d’écriture, soyez prêt à expliquer exactement comment et quand votre app modifie les données lors de la révision.

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

Assistant AI

Bonjour ! Posez-moi vos questions sur la documentation.

Commencez gratuitement avec Brevo