Repository navigation
v8.4.0 introduces an optional, experimental iOS Billing integration, updates the Payment and Identity SDKs, and improves web modal handling and Android Gradle Plugin compatibility.
Experimental Stripe Billing for iOS
The new @capacitor-community/stripe-billing package supports subscription buy buttons, Customer Sessions, active entitlements, the Customer Portal, and cache reset when changing accounts. It is independent of Payment, Identity, and Terminal; existing integrations do not need to install it.
Billing requires Capacitor 8, iOS 15+, Swift Package Manager, and a Stripe account enabled for the upstream private preview. CocoaPods, Android, and web are unsupported. A presented buy button is not payment confirmation; authenticate users and authorize subscription access on your backend.
The Angular demo now prepares temporary test customers and credentials automatically, so each Billing scenario starts with one tap.
See the Billing integration guide, #540, and #575.
Payment and Identity SDK updates
| Package | Stripe Android | Stripe iOS (SPM) | Stripe iOS (CocoaPods) | Web |
|---|---|---|---|---|
| Payment | 23.26.x | 26.15.1 | 26.15.0 | Stripe.js 9.17.x / stripe-pwa-elements 4.1.x |
| Identity | 23.26.x | 26.15.1 | 26.15.0 | Stripe.js 10.3.x |
Terminal remains on the Stripe Terminal 5.8.x SDKs. Resolved patch versions depend on dependency ranges and lockfiles.
The existing Capacitor 8 toolchain and minimum OS requirements remain unchanged: iOS 15+, Android API 24 for Payment/Identity, and API 26 for Terminal. Tap to Pay has additional device, OS, account, and regional requirements.
See #574.
Fixes and compatibility
- Web payments: use the public modal API in
stripe-pwa-elements4.1. The plugin no longer manipulates the inner modal to work around older element behavior. Update both web peer dependencies together. - Android Gradle Plugin 9: avoid applying the Kotlin Android plugin when built-in Kotlin is already present, and update the Gradle configuration to compatible APIs. An AGP upgrade is optional. See #560.
- Identity on Android: the updated Stripe SDK includes the LiteRT namespace fix, so the temporary dependency workaround is no longer needed with the default SDK. Apps overriding
identityVersionto an older SDK should check that SDK's compatibility. See #562 and #574. - Documentation: clarify app/backend responsibilities, platform setup, Identity response mapping, and wallet amount units. Wallet summary amounts use major currency units; server-side PaymentIntent amounts use the smallest currency unit. See #576.
Upgrading
Install only the packages your application uses, then synchronize native projects:
npm install @capacitor-community/stripe@8.4.0
# Optional integrations:
npm install @capacitor-community/stripe-identity@8.4.0
npm install @capacitor-community/stripe-terminal@8.4.0
npx cap syncFor Payment on web, install the compatible peers:
npm install @stripe/stripe-js@^9.17.0 stripe-pwa-elements@^4.1.0Identity's Stripe.js dependency is managed separately. Payment remains on Stripe.js 9 because its wallet implementation uses the Payment Request Button.
To add experimental Billing to an SPM-based iOS project:
npm install @capacitor-community/stripe-billing@8.4.0
npx cap sync iosFollow the Billing guide to configure the backend and register the Customer Session listener before initialization.
Existing Terminal JS dependency advisory
@stripe/terminal-js@0.26.0 pins ws@6.2.3, which is affected by GHSA-96hv-2xvq-fx4p. This upstream dependency can trigger npm audit warnings. Applications can apply the following override in their root package.json, then reinstall dependencies:
{
"overrides": {
"@stripe/terminal-js": {
"ws": "^6.2.6"
}
}
}Full changelog: v8.3.0...v8.4.0