Configuration des plateformes

Installez @capacitor-community/stripe et synchronisez les projets natifs. Capacitor 8 enregistre automatiquement le plugin : vous n’avez pas à modifier MainActivity ni à ajouter un appel manuel à registerPlugin.

npm install @capacitor-community/stripe
npx cap sync

Le plugin nécessite Capacitor 8 ou une version ultérieure. Sur le Web, la dépendance pair stripe-pwa-elements est également nécessaire. Conservez la clé secrète Stripe uniquement sur votre serveur. Consultez Intégration serveur.

Parcours du premier paiement

Suivez cet ordre pour réussir votre premier paiement avec PaymentSheet :

1. Terminez les étapes propres à la plateforme sur cette page.
2. Choisissez un seul guide de framework et initialisez Stripe à cet endroit (JavaScript natif, Angular ou React).
3. Créez un PaymentIntent de test sur votre serveur et renvoyez son secret client. Consultez Intégration serveur.
4. Présentez PaymentSheet, puis vérifiez le résultat de l’écouteur (Completed, Canceled ou Failed). L’état final du paiement reste déterminé par vos webhooks Stripe.

PaymentFlow, Apple Pay et Google Pay sont des options à explorer une fois PaymentSheet fonctionnel.

Configuration Android

Le plugin lui-même ne nécessite aucun enregistrement supplémentaire dans Gradle ou MainActivity.

Sur Android, Google Pay doit être configuré dans les métadonnées de l’application avant le chargement du plugin. Suivez le guide Google Pay.

Stripe Connect facultatif : si Google Pay sur Android doit utiliser un compte connecté, ajoutez la métadonnée com.getcapacitor.community.stripe.stripe_account. Sur le Web et en natif, PaymentSheet, PaymentFlow, Apple Pay et Google Pay acceptent également stripeAccount dans initialize.

Configuration iOS

Ajoutez NSCameraUsageDescription pour permettre à PaymentSheet de scanner les cartes :

  	<key>UIViewControllerBasedStatusBarAppearance</key>
	  <true/>

+   <key>NSCameraUsageDescription</key>
+   <string>Need camera access for read credit card.</string>
  </dict>

Le plugin se charge automatiquement sur iOS. Apple Pay nécessite également un Apple Merchant ID et un certificat. Suivez le guide Apple Pay.

Pour les redirections 3D Secure, définissez returnURL lors de la création de PaymentSheet ou PaymentFlow, puis appelez handleURLCallback depuis le gestionnaire d’URL de votre application. Consultez Initialisation.

Configuration Web

Installez stripe-pwa-elements et appelez defineCustomElements() une seule fois au démarrage. Servez l’application en HTTPS en développement comme en production.

Choisissez un seul démarrage rapide de framework (ce sont des alternatives, pas des étapes successives) :

• Démarrage rapide en JavaScript natif
• Démarrage rapide avec Angular
• Démarrage rapide avec React

Après l’initialisation, poursuivez avec Intégration serveur, puis PaymentSheet.