Skip to content

Releases

Ti.Paysheet 1.0.0

Choose a tag to compare

@joshualambert joshualambert released this 16 Nov 22:27

Ti.Paysheet 1.0.0 is the first release: Stripe's PaymentSheet and CustomerSheet for Titanium, on iOS and Android, built on Stripe's current SDKs.

Stripe's prebuilt payment UI is the safest way to take a card in a mobile app: card numbers never touch your code or your server, and Stripe handles 3-D Secure, saved cards and compliance. Titanium has had no maintained, openly licensed wrapper for the current SDKs. The ones that exist wrap 2023-era versions, accept only ephemeral keys (which pin your server to an old Stripe API version), and on iOS cannot hand a 3-D Secure redirect back to the app. This module wraps stripe-ios 26.16.x and stripe-android 23.26.0, accepts a Customer Session client secret or an ephemeral key, and keeps the JavaScript API identical on both platforms.

PaymentSheet card form on iOS PaymentSheet card form on Android CustomerSheet with a saved card on iOS

What is in it

  • PaymentSheet in payment mode (PaymentIntent) and setup mode (SetupIntent).
  • CustomerSheet: list, add, remove and select saved payment methods.
  • Customer Session client secret (preferred) or an ephemeral key.
  • One result per presentation: completed, canceled or failed, with Stripe's error code, message, decline code and type.
  • 3-D Secure handled for you. On iOS the redirect comes back to the app automatically. On Android the result survives rotation and process death.
  • Promises or a Node-style callback. A wrong argument rejects with code: 'invalid_argument' and the option's name; nothing throws synchronously.
  • Appearance: colours, corner radius, borders, fonts and the primary button.
  • Apple Pay and Google Pay as opt-in configuration (not tested in this release, see below).
  • A version guard on iOS: the module refuses to present if the app links a different stripe-ios than it was built against, and spm.json pins the version exactly.
  • Nothing sensitive in logs: no URLs, secrets or Stripe error messages.

The README has the full API, the tiapp.xml entries, what your server must provide, and the platform notes. The complete list is in the changelog.

Install

Download the zips for your platforms below and unzip them into your project root (each contains a modules/ directory):

unzip ti.paysheet-android-1.0.0.zip -d /path/to/your/app
unzip ti.paysheet-iphone-1.0.0.zip -d /path/to/your/app
<modules>
    <module>ti.paysheet</module>
</modules>

iOS also needs a URL scheme in tiapp.xml for 3-D Secure redirects; the README's Install section shows it. The iOS build fetches stripe-ios as a Swift Package the first time.

Requirements

Titanium SDK 13.4.0.GA or later (the iOS side uses the Swift Package support that arrived in 13.4), iOS 15 or later, Android API 24 or later.

Checked on

Titanium SDK 13.4.1.GA with Stripe test-mode keys, on an Android 15 (API 35) image and an iOS 27.0 simulator with Xcode 27.1: card payments as a guest and with a Customer Session, saved cards, declined cards, 3-D Secure by challenge and by redirect, setup mode, CustomerSheet, rotation with the sheet open, and a process killed during 3-D Secure. The README's Verification table lists every check and its result on each platform.

Not tested in this release: Apple Pay, Google Pay and custom fonts. Since the scripted checks were run, the module has also been used on physical devices in live apps.

Checksums (SHA-256)

c9990670cb80ab9d6ce9d5e844ba665583677d417e26c2c033ebb44381c90832  ti.paysheet-android-1.0.0.zip
414bfba05c388a428fc9d13957147987a8fa7316f3bd4b52f9d515dfd69ec33f  ti.paysheet-iphone-1.0.0.zip

Licensed under Apache-2.0. Stripe is a trademark of Stripe, Inc.; this module is not made or endorsed by Stripe.