The skip-stripe framework is available at https://github.com/skiptools/skip-stripe.git, which can be checked out and tested with skip test
once Skip is installed.
SkipStripe
This is a free Skip Swift/Kotlin framework that contains integration with the Stripe SDK’s ‘Mobile Payment Element for iOS and Android.
Setup
To include this framework in your project, add the following
dependency to your Package.swift
file:
let package = Package(
name: "my-package",
products: [
.library(name: "MyProduct", targets: ["MyTarget"]),
],
dependencies: [
.package(url: "https://source.skip.tools/skip-stripe.git", "0.0.0"..<"2.0.0"),
],
targets: [
.target(name: "MyTarget", dependencies: [
.product(name: "SkipStripe", package: "skip-stripe")
])
]
)
Usage
The API includes a StripePaymentButton
which is created using a StripePaymentConfiguration
.
For information on how to initialize the configuration object, see the Stripe documentation for iOS and Android.
The SkiperStrip
sample app in this repository shows a complete Skip-to-native integration using:
skip-stripe/examples/PaymentSheetService.swift
– wrapper around Stripe’s iOS payment sheet presenter.skip-stripe/examples/StripePaymentService.swift
– shared service that creates payment intents, ephemeral keys, and SkipStripe configurations for Android.skip-stripe/examples/ContentView.swift
– SwiftUI screen demonstrating both iOS and Android flows withSimpleStripePaymentButton
.
import SkipStripe
struct PaymentButton: View {
let paymentConfig = StripePaymentConfiguration(
publishableKey: "PUBLISHABLE_KEY",
merchantName: "Merchant, Inc.",
customerID: "CUSTOMER_ID",
ephemeralKeySecret: "EPHEMERAL_KEY_SECRET",
clientSecret: "CLIENT_SECRET"
)
var body: some View {
StripePaymentButton(configuration: paymentConfig, completion: paymentCompletion) {
Text("Pay Now!")
}
.buttonStyle(.borderedProminent)
}
func paymentCompletion(result: StripePaymentResult) {
switch result {
case .completed:
logger.log("Payment completed")
case .canceled:
logger.log("Payment canceled")
case .failed(error: let error):
logger.log("Payment error: \(error)")
}
}
}
Usage Notes
Using Stripe for payments is subject to the policies of the app marketplace that distributes the application. Generally speaking, they can be used for purchases and subscriptions for non-digital goods, whereas digital purchses usually use the native billing system of the hosting service.
For more details, see:
- Make in-app purchases in Android apps
- Understanding Google Play’s Payments policy
- Apple App Review Guidelines: In-App Purchase
- Apple Human Interface Guidelines: In-app purchase
For interfacing with the native in-app purchasing system on the host device, consider using the SkipMarketplace framework instead.
Building
This project is a free Swift Package Manager module that uses the Skip plugin to transpile Swift into Kotlin.
Building the module requires that Skip be installed using
Homebrew with brew install skiptools/skip/skip
.
This will also install the necessary build prerequisites:
Kotlin, Gradle, and the Android build tools.
Testing
The module can be tested using the standard swift test
command
or by running the test target for the macOS destination in Xcode,
which will run the Swift tests as well as the transpiled
Kotlin JUnit tests in the Robolectric Android simulation environment.
Parity testing can be performed with skip test
,
which will output a table of the test results for both platforms.