Bug Fixes #

• Added Address class to the olo_pay_sdk_data_classes barrel file
• Added CurrencyCode enum to the olo_pay_sdk_data_classes barrel file

Overview #

• Digital wallets overhaul
  • Digital wallets now use a DigitalWalletConfiguration object that bundles all information needed to process transactions
  • Digital wallet configurations for both Apple Pay and Google Pay can be updated
  • New DigitalWalletButton class that supports both Apple Pay and Google Pay buttons
  • Add support for line items
• Simplified the SDK setup process
• New form widget for entering credit card details.

Updates #

• OloPaySdk
  • Added updateDigitalWalletConfiguration()
• DigitalWalletPaymentParameters
  • Added googlePayCheckoutStatus property
• ErrorCodes
  • Added emptyCompanyName property
  • Added emptyCountryCode property
  • Added invalidCountryCode property
  • Added lineItemTotalMismatch property
• BackgroundStyles
  • Added noPadding property
  • Added formDefaults property
• TextStyles
  • Added formDefaults property
  • Added defaultErrorFontSize property
  • Added errorTextSize property
  • Added errorAssetFont property
• Hints
  • Added formDefaults property
  • Added formFocusedDefaults property
  • Added singleLineOnly constructor
  • Added formOnly constructor
  • Added formFocusedOnly constructor
• DigitalWalletPaymentParameters
  • Added type property
  • Added status property
• CardDetailsSingleLineTextField: Added enabled property
• CvvTextField: Added enabled property
• PaymentMethod
  • Added digitalWalletCardDescription property
  • Added email property
  • Added phoneNumber property
  • Added fullName property
  • Added billingAddress property
• New Classes/Enums
  • Introduce the CardDetailsFormTextField widget
  • Introduce the DigitalWalletButton
  • Added CurrencyCode enum
  • Added DigitalWalletConfiguration
  • Added GooglePayButtonConfiguration
  • Added GooglePayButtonTheme
  • Added GooglePayButtonType
  • Added ApplePayConfiguration
  • Added ApplePayButtonConfiguration
  • Added ApplePayButtonStyle
  • Added ApplePayButtonType
  • Added GooglePayCheckoutStatus
  • Added Address
  • Added FieldDividerStyles
  • Added ErrorBackgroundStyles
  • Added DigitalWalletLineItem
  • Added DigitalWalletLineItemStatus
  • Added DigitalWalletLineItemType

Breaking Changes #

• OloPaySdk
  • Changed method signature of initializeOloPay()
  • Removed changeGooglePayVendor() in favor of updateDigitalWalletConfiguration()
  • onDigitalWalletReady may now be called multiple times for both Apple Pay and Google Pay (See documentation for details)
• ApplePaySetupParameters
  • Renamed to ApplePayConfiguration
  • Moved properties common to Apple Pay and Google Pay into DigitalWalletConfiguration
• GooglePaySetupParameters
  • Renamed to GooglePayConfiguration
  • Moved properties common to Apple Pay and Google Pay into DigitalWalletConfiguration
• DigitalWalletPaymentParameters
  • Removed currencyMultiplier property (See GooglePayConfiguration)
  • Removed currencyCode property (See GooglePayConfiguration and ApplePayConfiguration)
  • Removed countryCode property (See GooglePayConfiguration and ApplePayConfiguration)
• ErrorCodes
  • Removed previously deprecated missingParameter property
  • Renamed googlePayUninitialized property to uninitializedDigitalWallet because it now applies to both Google Pay and Apple Pay
  • Renamed googlePayNotReady property to digitalWalletNotReady because it now applies to both Google Pay and Apple Pay
• CardDetailsSingleLineTextFieldController: Removed setEnabled() in favor of CardDetailsSingleLineTextField.enabled property
• CvvTextFieldController: Removed setEnabled() in favor of CvvTextField.enabled property
• Hints
  • Renamed defaults property to singleLineDefaults
• Removed Classes
  • GooglePayVendorParameters (see DigitalWalletConfiguration and GooglePayConfiguration)
  • OloPaySetupParameters

Dependency Updates #

• Native SDKs

  • Updated to use Olo Pay Android SDK v4.1.0
  • Updated to use Olo Pay iOS SDK v5.2.0

• Android

  • Updated to Gradle v8.7
  • Updated to compile SDK to 35
  • Updated to com.android.tools.build:gradle:8.6.1
  • Updated to androidx.constraintlayout:constraintlayout:2.2.0
  • Updated to androidx.core:core-ktx:1.15.0
  • Updated to org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0

Updates #

• CardDetailsSingleLineTextField: Added ability to set alignment of the built in error message with errorAlignment
• CardDetailsSingleLineTextField: Changed default maxHeight to 45
• CardDetailsSingleLineTextField: Changed default errorMarginTop to 8.0
• Deprecated ErrorCodes.missingParameter: All previous usages have changed to ErrorCodes.InvalidParameter
• Introduce CvvTextField widget for CVV tokenization.

Dependency Updates #

• Native SDKs

  • Updated to use Olo Pay Android SDK v3.1.1
  • Updated to use Olo Pay iOS SDK v4.0.2

• Android Project

  • Updated to Gradle v8.2
  • Updated to Java v17
  • Updated to com.android.tools.build:gradle:8.2.2
  • Updated to androidx.core:core-ktx:1.13.1
  • Updated to org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1
  • Updated to com.google.android.material:material:1.12.0

Bug Fixes #

• CardDetailsSingleLineTextField: Fix bug causing slight difference between the default input text error state color and the default error message color.
• CardDetailsSingleLineTextField: Fixed constraints so that the text input widget height properly expands/shrinks to match the height specified by the constructor parameters

Breaking Changes #

• OloPaySetupParameters: Removed freshSetup parameter

Updates #

• CardDetailsSingleLineTextField: Added built-in error message label to automatically display error messages
• CardDetailsSingleLineTextField: Added errorStyles property to style the built-in error message label
• CardDetailsSingleLineTextField: Added displayErrorMessages property to control visibility of the error message label
• CardDetailsSingleLineTextField: Added custom error message support via the customErrorMessages property
• CardDetailsSingleLineTextField: Added support for custom fonts via TextStyles
• CardDetailsSingleLineTextField: Fixed issue on iOS sometimes causing duplicate error messages to display
• OloPaySdk: Added getFontNames() for help with debugging custom font issues on iOS
• OloPaySdk: Changed isDigitalWalletReady() on iOS so it returns false if the SDK isn't initialized to align with Android behavior
• TextStyles: Added fontAsset and iOSFontName properties

Bug Fixes #

• CardDetailsSingleLineTextField: Fix small edge case preventing textStyles and paddingStyles from respecting theme values
• CardType: Fix typo causing Mastercard cards to map to CardType.unknown

Updates #

• TextStyles: Fixed incorrect documentation for merge()
• TextStyles: Added defaultCursorColor property

Updates #

• ReadMe updates

Breaking Changes #

• Consolidate import statements so only one is required
• Renamed classes and types for clarity
  • PaymentCardDetailsSingleLineWidget --> CardDetailsSingleLineTextField
  • PaymentCardDetailsSingleLineWidgetController --> CardDetailsSingleLineTextFieldController
  • PaymentCardDetailsSingleLineWidgetControllerCreated --> CardDetailsSingleLineTextFieldControllerCreated
  • PaymentCardDetailsSingleLineWidgetOnErrorMessageChanged --> CardDetailsErrorMessageChanged
  • PaymentCardDetailsSingleLineWidgetOnInputChanged --> CardDetailsInputChanged
  • PaymentCardDetailsSingleLineWidgetOnValidStateChanged --> CardDetailsValidStateChanged
  • PaymentCardDetailsSingleLineWidgetOnFocusChanged --> CardDetailsFocusChanged
• PaymentMethod.cardType: Changed type from String to CardType
• Updated all data classes to use final properties and const constructors
  • OloPaySetupParameters
  • GooglePaySetupParameters
  • ApplePaySetupParameters
  • DigitalWalletPaymentParameters
  • GooglePayVendorParameters
  • PaymentMethod
  • CardFieldState
  • Hints
  • TextStyles
  • BackgroundStyles
  • PaddingStyles

Updates #

• Change minimum iOS version to iOS 13
• CardDetailsSingleLineTextField: Add support for light/dark themes
• CardDetailsSingleLineTextField: Add explicit default styles
• CardDetailsSingleLineTextField: Add support for updating styles based on state changes

Breaking Changes #

• OloPaySdk.initializeOloPay(): Changed from positional to named parameters
• PaymentCardDetailsSingleLineWidgetControllerCreated: Moved typedef to data_types.dart
• PaymentCardDetailsSingleLineWidget: Changed onControllerCreated to a required parameter

Updates #

• PaymentCardDetailsSingleLineWidget: Background and text styling support
• PaymentCardDetailsSingleLineWidget: Added event handlers for error message changes, valid state changes, and input changes
• PaymentCardDetailsSingleLineWigetController: Additional methods for controlling/interacting with the widget
• Digital Wallet Support (Apple Pay & Google Pay)

Initial Release #

• Use PaymentCardDetailsSingleLineWidget to display a single line card input widget
• Use PaymentCardDetailsSingleLineWidgetController.createPaymentMethod to create a payment method based on user-entered card details
• Uses Olo Pay Android SDK v3.0.0
• Uses Olo Pay iOS SDK v4.0.0