Stripe
@capacitor-community/stripe
Capacitor community plugin for native Stripe.
Since 4.2.0, require compileSdkVersion "33" at Android
Since version 4.2.0, this plugin requires compileSdkVersion "33". (Capacitor 4's default compileSdkVersion is "32").
Plugin version
compileSdkVersion
4.1.2
32
4.2.0
33
Updated Google Pay button to match new brand guidelines.
[CHANGED]5679 Fix oversized verification_frames payloads leading to failed scans.
See more info: https://github.com/stripe/stripe-android/releases
Most of the time it will be fine, but it may conflict with other plugins. If this, you should use released version. We can't support conflict with other plugins.
Maintainers
Contributors ✨
Made with contributors-img .
How to use
Learn at the official @capacitor-community/stripe documentation .
日本語版をご利用の際は ja.stripe.capacitorjs.jp をご確認ください。
Demo
Screenshots
Android
iOS
Web
PaymentSheet
PaymentFlow
ApplePay
Not supported
beta.
GooglePay
Not supported
Identity
Not supported
API
isApplePayAvailable()
createApplePay(...)
presentApplePay()
addListener(ApplePayEventsEnum.Loaded, ...)
addListener(ApplePayEventsEnum.FailedToLoad, ...)
addListener(ApplePayEventsEnum.Completed, ...)
addListener(ApplePayEventsEnum.Canceled, ...)
addListener(ApplePayEventsEnum.Failed, ...)
addListener(ApplePayEventsEnum.DidSelectShippingContact, ...)
addListener(ApplePayEventsEnum.DidCreatePaymentMethod, ...)
isGooglePayAvailable()
createGooglePay(...)
presentGooglePay()
addListener(GooglePayEventsEnum.Loaded, ...)
addListener(GooglePayEventsEnum.FailedToLoad, ...)
addListener(GooglePayEventsEnum.Completed, ...)
addListener(GooglePayEventsEnum.Canceled, ...)
addListener(GooglePayEventsEnum.Failed, ...)
createIdentityVerificationSheet(...)
presentIdentityVerificationSheet()
addListener(IdentityVerificationSheetEventsEnum.Loaded, ...)
addListener(IdentityVerificationSheetEventsEnum.FailedToLoad, ...)
addListener(IdentityVerificationSheetEventsEnum.Completed, ...)
addListener(IdentityVerificationSheetEventsEnum.Canceled, ...)
addListener(IdentityVerificationSheetEventsEnum.Failed, ...)
createPaymentFlow(...)
presentPaymentFlow()
confirmPaymentFlow()
addListener(PaymentFlowEventsEnum.Loaded, ...)
addListener(PaymentFlowEventsEnum.FailedToLoad, ...)
addListener(PaymentFlowEventsEnum.Opened, ...)
addListener(PaymentFlowEventsEnum.Completed, ...)
addListener(PaymentFlowEventsEnum.Canceled, ...)
addListener(PaymentFlowEventsEnum.Failed, ...)
addListener(PaymentFlowEventsEnum.Created, ...)
createPaymentSheet(...)
presentPaymentSheet()
addListener(PaymentSheetEventsEnum.Loaded, ...)
addListener(PaymentSheetEventsEnum.FailedToLoad, ...)
addListener(PaymentSheetEventsEnum.Completed, ...)
addListener(PaymentSheetEventsEnum.Canceled, ...)
addListener(PaymentSheetEventsEnum.Failed, ...)
initialize(...)
handleURLCallback(...)
Interfaces
Type Aliases
Enums
This is for @capacitor/docgen only.
Not use in product.
isApplePayAvailable()
isApplePayAvailable ( ) = > Promise < void >
createApplePay(...)
createApplePay ( options : CreateApplePayOption ) = > Promise < void >
presentApplePay()
presentApplePay ( ) = > Promise < { paymentResult : ApplePayResultInterface ; } >
Returns: Promise<{ paymentResult: ApplePayResultInterface ; }>
addListener(ApplePayEventsEnum.Loaded, ...)
addListener ( eventName : ApplePayEventsEnum . Loaded , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(ApplePayEventsEnum.FailedToLoad, ...)
addListener ( eventName : ApplePayEventsEnum . FailedToLoad , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(ApplePayEventsEnum.Completed, ...)
addListener ( eventName : ApplePayEventsEnum . Completed , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(ApplePayEventsEnum.Canceled, ...)
addListener ( eventName : ApplePayEventsEnum . Canceled , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(ApplePayEventsEnum.Failed, ...)
addListener ( eventName : ApplePayEventsEnum . Failed , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(ApplePayEventsEnum.DidSelectShippingContact, ...)
addListener ( eventName : ApplePayEventsEnum . DidSelectShippingContact , listenerFunc : ( data : DidSelectShippingContact ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(ApplePayEventsEnum.DidCreatePaymentMethod, ...)
addListener ( eventName : ApplePayEventsEnum . DidCreatePaymentMethod , listenerFunc : ( data : DidSelectShippingContact ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
isGooglePayAvailable()
isGooglePayAvailable ( ) = > Promise < void >
createGooglePay(...)
createGooglePay ( options : CreateGooglePayOption ) = > Promise < void >
presentGooglePay()
presentGooglePay ( ) = > Promise < { paymentResult : GooglePayResultInterface ; } >
Returns: Promise<{ paymentResult: GooglePayResultInterface ; }>
addListener(GooglePayEventsEnum.Loaded, ...)
addListener ( eventName : GooglePayEventsEnum . Loaded , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(GooglePayEventsEnum.FailedToLoad, ...)
addListener ( eventName : GooglePayEventsEnum . FailedToLoad , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(GooglePayEventsEnum.Completed, ...)
addListener ( eventName : GooglePayEventsEnum . Completed , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(GooglePayEventsEnum.Canceled, ...)
addListener ( eventName : GooglePayEventsEnum . Canceled , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(GooglePayEventsEnum.Failed, ...)
addListener ( eventName : GooglePayEventsEnum . Failed , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
createIdentityVerificationSheet(...)
createIdentityVerificationSheet ( options : CreateIdentityVerificationSheetOption ) = > Promise < void >
presentIdentityVerificationSheet()
presentIdentityVerificationSheet ( ) = > Promise < { identityVerificationResult : IdentityVerificationSheetResultInterface ; } >
Returns: Promise<{ identityVerificationResult: IdentityVerificationSheetResultInterface ; }>
addListener(IdentityVerificationSheetEventsEnum.Loaded, ...)
addListener ( eventName : IdentityVerificationSheetEventsEnum . Loaded , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(IdentityVerificationSheetEventsEnum.FailedToLoad, ...)
addListener ( eventName : IdentityVerificationSheetEventsEnum . FailedToLoad , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(IdentityVerificationSheetEventsEnum.Completed, ...)
addListener ( eventName : IdentityVerificationSheetEventsEnum . Completed , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(IdentityVerificationSheetEventsEnum.Canceled, ...)
addListener ( eventName : IdentityVerificationSheetEventsEnum . Canceled , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(IdentityVerificationSheetEventsEnum.Failed, ...)
addListener ( eventName : IdentityVerificationSheetEventsEnum . Failed , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
createPaymentFlow(...)
createPaymentFlow ( options : CreatePaymentFlowOption ) = > Promise < void >
presentPaymentFlow()
presentPaymentFlow ( ) = > Promise < { cardNumber : string ; } >
Returns: Promise<{ cardNumber: string; }>
confirmPaymentFlow()
confirmPaymentFlow ( ) = > Promise < { paymentResult : PaymentFlowResultInterface ; } >
Returns: Promise<{ paymentResult: PaymentFlowResultInterface ; }>
addListener(PaymentFlowEventsEnum.Loaded, ...)
addListener ( eventName : PaymentFlowEventsEnum . Loaded , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentFlowEventsEnum.FailedToLoad, ...)
addListener ( eventName : PaymentFlowEventsEnum . FailedToLoad , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentFlowEventsEnum.Opened, ...)
addListener ( eventName : PaymentFlowEventsEnum . Opened , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentFlowEventsEnum.Completed, ...)
addListener ( eventName : PaymentFlowEventsEnum . Completed , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentFlowEventsEnum.Canceled, ...)
addListener ( eventName : PaymentFlowEventsEnum . Canceled , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentFlowEventsEnum.Failed, ...)
addListener ( eventName : PaymentFlowEventsEnum . Failed , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentFlowEventsEnum.Created, ...)
addListener ( eventName : PaymentFlowEventsEnum . Created , listenerFunc : ( info : { cardNumber : string ; } ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
createPaymentSheet(...)
createPaymentSheet ( options : CreatePaymentSheetOption ) = > Promise < void >
presentPaymentSheet()
presentPaymentSheet ( ) = > Promise < { paymentResult : PaymentSheetResultInterface ; } >
Returns: Promise<{ paymentResult: PaymentSheetResultInterface ; }>
addListener(PaymentSheetEventsEnum.Loaded, ...)
addListener ( eventName : PaymentSheetEventsEnum . Loaded , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentSheetEventsEnum.FailedToLoad, ...)
addListener ( eventName : PaymentSheetEventsEnum . FailedToLoad , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentSheetEventsEnum.Completed, ...)
addListener ( eventName : PaymentSheetEventsEnum . Completed , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentSheetEventsEnum.Canceled, ...)
addListener ( eventName : PaymentSheetEventsEnum . Canceled , listenerFunc : ( ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
addListener(PaymentSheetEventsEnum.Failed, ...)
addListener ( eventName : PaymentSheetEventsEnum . Failed , listenerFunc : ( error : string ) = > void ) => PluginListenerHandle
Returns: PluginListenerHandle
initialize(...)
initialize ( opts : StripeInitializationOptions ) = > Promise < void >
handleURLCallback(...)
handleURLCallback ( opts : StripeURLHandlingOptions ) = > Promise < void >
iOS Only
Interfaces
CreateApplePayOption
Prop
Type
paymentIntentClientSecret
string
paymentSummaryItems
{ label: string; amount: number; }[]
merchantIdentifier
string
countryCode
string
currency
string
requiredShippingContactFields
('postalAddress' | 'phoneNumber' | 'emailAddress' | 'name')[]
PluginListenerHandle
Prop
Type
remove
() => Promise<void>
DidSelectShippingContact
ShippingContact
Prop
Type
Description
givenName
string
Apple Pay only
familyName
string
Apple Pay only
middleName
string
Apple Pay only
namePrefix
string
Apple Pay only
nameSuffix
string
Apple Pay only
nameFormatted
string
Apple Pay only
phoneNumber
string
Apple Pay only
nickname
string
Apple Pay only
street
string
Apple Pay only
city
string
Apple Pay only
state
string
Apple Pay only
postalCode
string
Apple Pay only
country
string
Apple Pay only
isoCountryCode
string
Apple Pay only
subAdministrativeArea
string
Apple Pay only
subLocality
string
Apple Pay only
CreateGooglePayOption
Prop
Type
Description
paymentIntentClientSecret
string
paymentSummaryItems
{ label: string; amount: number; }[]
Web only need @stripe-elements/stripe-elements > 1.1.0
merchantIdentifier
string
Web only need @stripe-elements/stripe-elements > 1.1.0
countryCode
string
Web only need @stripe-elements/stripe-elements > 1.1.0
currency
string
Web only need @stripe-elements/stripe-elements > 1.1.0
CreateIdentityVerificationSheetOption
Prop
Type
verificationId
string
ephemeralKeySecret
string
CreatePaymentFlowOption
Prop
Type
Description
Default
paymentIntentClientSecret
string
Any documentation call 'paymentIntent' Set paymentIntentClientSecret or setupIntentClientSecret
setupIntentClientSecret
string
Any documentation call 'paymentIntent' Set paymentIntentClientSecret or setupIntentClientSecret
customerEphemeralKeySecret
string
Any documentation call 'ephemeralKey'
customerId
string
Any documentation call 'customer'
enableApplePay
boolean
If you set payment method ApplePay, this set true
false
applePayMerchantId
string
If set enableApplePay false, Plugin ignore here.
enableGooglePay
boolean
If you set payment method GooglePay, this set true
false
GooglePayIsTesting
boolean
false,
countryCode
string
use ApplePay and GooglePay. If set enableApplePay and enableGooglePay false, Plugin ignore here.
"US"
merchantDisplayName
string
"App Name"
returnURL
string
""
style
'alwaysLight' | 'alwaysDark'
iOS Only
undefined
withZipCode
boolean
Platform: Web only Show ZIP code field.
true
CreatePaymentSheetOption
Prop
Type
Description
Default
paymentIntentClientSecret
string
Any documentation call 'paymentIntent' Set paymentIntentClientSecret or setupIntentClientSecret
setupIntentClientSecret
string
Any documentation call 'paymentIntent' Set paymentIntentClientSecret or setupIntentClientSecret
customerEphemeralKeySecret
string
Any documentation call 'ephemeralKey'
customerId
string
Any documentation call 'customer'
enableApplePay
boolean
If you set payment method ApplePay, this set true
false
applePayMerchantId
string
If set enableApplePay false, Plugin ignore here.
enableGooglePay
boolean
If you set payment method GooglePay, this set true
false
GooglePayIsTesting
boolean
false,
countryCode
string
use ApplePay and GooglePay. If set enableApplePay and enableGooglePay false, Plugin ignore here.
"US"
merchantDisplayName
string
"App Name"
returnURL
string
""
style
'alwaysLight' | 'alwaysDark'
iOS Only
undefined
withZipCode
boolean
Platform: Web only Show ZIP code field.
true
StripeInitializationOptions
Prop
Type
Description
publishableKey
string
stripeAccount
string
Optional. Making API calls for connected accounts
StripeURLHandlingOptions
StripePlugin
CapacitorStripeContext
Prop
Type
stripe
StripePlugin
isApplePayAvailable
boolean
isGooglePayAvailable
boolean
Type Aliases
ApplePayResultInterface
ApplePayEventsEnum.Completed | ApplePayEventsEnum.Canceled | ApplePayEventsEnum.Failed | ApplePayEventsEnum.DidSelectShippingContact | ApplePayEventsEnum.DidCreatePaymentMethod
GooglePayResultInterface
GooglePayEventsEnum.Completed | GooglePayEventsEnum.Canceled | GooglePayEventsEnum.Failed
IdentityVerificationSheetResultInterface
IdentityVerificationSheetEventsEnum.Completed | IdentityVerificationSheetEventsEnum.Canceled | IdentityVerificationSheetEventsEnum.Failed
PaymentFlowResultInterface
PaymentFlowEventsEnum.Completed | PaymentFlowEventsEnum.Canceled | PaymentFlowEventsEnum.Failed
PaymentSheetResultInterface
PaymentSheetEventsEnum.Completed | PaymentSheetEventsEnum.Canceled | PaymentSheetEventsEnum.Failed
Enums
ApplePayEventsEnum
Members
Value
Loaded
"applePayLoaded"
FailedToLoad
"applePayFailedToLoad"
Completed
"applePayCompleted"
Canceled
"applePayCanceled"
Failed
"applePayFailed"
DidSelectShippingContact
"applePayDidSelectShippingContact"
DidCreatePaymentMethod
"applePayDidCreatePaymentMethod"
GooglePayEventsEnum
Members
Value
Loaded
"googlePayLoaded"
FailedToLoad
"googlePayFailedToLoad"
Completed
"googlePayCompleted"
Canceled
"googlePayCanceled"
Failed
"googlePayFailed"
IdentityVerificationSheetEventsEnum
Members
Value
Loaded
"identityVerificationSheetLoaded"
FailedToLoad
"identityVerificationSheetFailedToLoad"
Completed
"identityVerificationSheetCompleted"
Canceled
"identityVerificationSheetCanceled"
Failed
"identityVerificationSheetFailed"
PaymentFlowEventsEnum
Members
Value
Loaded
"paymentFlowLoaded"
FailedToLoad
"paymentFlowFailedToLoad"
Opened
"paymentFlowOpened"
Created
"paymentFlowCreated"
Completed
"paymentFlowCompleted"
Canceled
"paymentFlowCanceled"
Failed
"paymentFlowFailed"
PaymentSheetEventsEnum
Members
Value
Loaded
"paymentSheetLoaded"
FailedToLoad
"paymentSheetFailedToLoad"
Completed
"paymentSheetCompleted"
Canceled
"paymentSheetCanceled"
Failed
"paymentSheetFailed"
License
@capacitor-community/stripe is MIT licensed .