Question 1

How to customize the separator in Caishen card number text field?

Accepted Answer

Set the cardNumberSeparator property on the CardTextField, either in code or Interface Builder; for example, change it from the default ' - ' to a different string like '/' to match your app's design. The README shows this in the customization table under cardNumberSeparator.

Question 2

Does Caishen work with SwiftUI or is it only for UIKit?

Accepted Answer

Caishen is built for UIKit and does not provide native SwiftUI components; you'll need to wrap it in a UIViewRepresentable for use in SwiftUI projects, which adds extra implementation steps. The framework's documentation focuses on UIKit integration.

Question 3

Caishen vs PaymentKit: which is better for iOS Swift projects?

Accepted Answer

Caishen is a pure Swift alternative to PaymentKit, offering more customization and CardIO integration, while PaymentKit might be simpler for Stripe-centric apps. Choose Caishen if you need flexibility and Swift-native code, but note that both require similar setup for validation.

Question 4

How to integrate CardIO scanning with Caishen in my app?

Accepted Answer

Implement the CardIOPaymentViewControllerDelegate in your view controller, set up the accessory button action to present CardIO, and use prefillCardInformation to populate the text field, as detailed in the README's CardIO integration example with code snippets.

Question 5

Can I use Caishen without CardIO for manual input only?

Accepted Answer

Yes, CardIO is optional; you can disable the accessory button or omit the integration, and Caishen will function solely as a manual input text field with validation. The README shows how to handle this by returning nil for accessory actions in the delegate.

Question 6

How to add custom card types with specific validation rules in Caishen?

Accepted Answer

Define a struct conforming to the CardType protocol with properties like identifyingDigits and CVCLength, then register it via cardTypeRegister, as illustrated in the README's MyCardType example with numberGrouping and validation flags.

Question 7

Is Caishen compatible with the latest iOS versions like iOS 17?

Accepted Answer

The README specifies iOS 8.0+ and Xcode 10.0+, but it doesn't explicitly mention testing on newer versions; while it likely works, you may need to verify compatibility or handle any UIKit changes in recent iOS updates yourself.

Caishen

What is Caishen?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions