On this page

Référence App Manifest

Le fichier stripe-app.json est la configuration centrale de votre Stripe App. Il déclare l’identité de votre app, ses permissions, vues UI, politiques de sécurité et comportement post-installation.

Exemple de Manifest complet

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "sandbox_install_compatible": true,
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback",
    "https://tajo.io/stripe/oauth/complete"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      }
    ],
    "content_security_policy": {
      "connect-src": ["https://api.tajo.io", "https://api.brevo.com"],
      "purpose": "Connect to Tajo API for data sync and Brevo API for contact management"
    }
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

Référence du schéma

Champs de premier niveau

Champ	Type	Requis	Description
`id`	string	Oui	Identifiant unique en notation de domaine inversé
`version`	string	Oui	Chaîne de version sémantique (ex : `"1.2.0"`)
`name`	string	Oui	Nom d’affichage sur le marketplace (max 35 caractères)
`icon`	string	Oui	Chemin relatif vers l’icône (PNG ou SVG 300x300)
`distribution_type`	string	Oui	`"public"` pour le marketplace ou `"private"` pour usage interne
`permissions`	PermissionRequest[]	Oui	Tableau de demandes de permissions
`ui_extension`	UIExtensionManifest	Non	Configuration de l’extension UI
`post_install_action`	PostInstallAction	Non	Action après l’installation

Validation

# Validate manifest syntax and schema
stripe apps validate

# Check for common issues
stripe apps check

Caution

N’incluez que les domaines dont votre app a réellement besoin dans la CSP. Des entrées CSP excessives peuvent déclencher un examen supplémentaire lors de la révision.