Configuration

Install @capacitor-community/stripe and synchronize the native projects. Capacitor 8 registers the plugin automatically, so you do not edit MainActivity or add a manual registerPlugin call.

npm install @capacitor-community/stripe
npx cap sync

The plugin depends on Capacitor 8 or later. Web also needs the stripe-pwa-elements peer dependency. Keep the Stripe secret key on your server only. See Server Integration.

First payment path

Use this order for the first successful PaymentSheet run:

1. Finish the platform steps on this page.
2. Pick one framework guide and initialize Stripe there (Vanilla JS, Angular, or React).
3. Create a test PaymentIntent on your server and return the client secret. See Server Integration.
4. Present PaymentSheet, then confirm the listener result (Completed, Canceled, or Failed). Final payment state still comes from your Stripe webhooks.

PaymentFlow, Apple Pay, and Google Pay are later options after PaymentSheet works.

Android configuration

No extra Gradle or MainActivity registration is required for the plugin itself.

Google Pay on Android must be configured with application metadata before the plugin loads. Follow Google Pay.

Optional Stripe Connect: if Android Google Pay should run against a connected account, add com.getcapacitor.community.stripe.stripe_account metadata. Native and web PaymentSheet, PaymentFlow, Apple Pay, and Google Pay also accept stripeAccount on initialize.

iOS configuration

Add NSCameraUsageDescription so PaymentSheet can scan cards:

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

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

The plugin loads automatically on iOS. Apple Pay also needs an Apple Merchant ID and certificate. Follow Apple Pay.

For 3D Secure redirects, set returnURL when you create PaymentSheet or PaymentFlow, then call handleURLCallback from your app URL handler. See Initialize.

Web configuration

Install stripe-pwa-elements and call defineCustomElements() once during bootstrap. Serve the app over HTTPS in development and production.

Choose one framework quick start (they are alternatives, not a sequence):

• Vanilla JS Quick start
• Angular Quick start
• React Quick start

After initialization, continue with Server Integration, then PaymentSheet.