App crash on launch – "Unable to find an entity with name 'TIPPTippingPreferences'" when initializing Mobile Payments SDK

[honeykinng345]

My iOS app crashes immediately after initializing SquareMobilePaymentsSDK with the following exception:
*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Unable to find an entity with name 'TIPPTippingPreferences'.'
I’m using the square_mobile_payments_sdk Flutter plugin (version 2025.7.2), which internally uses the SquareMobilePaymentsSDK.xcframework.
The SDK appears to initialize successfully, but the app terminates during runtime with the above exception.

Steps to Reproduce:
Add dependency in Flutter:
dependencies:
square_mobile_payments_sdk: ^2025.7.2

Initialize the SDK in AppDelegate.swift:

import SquareMobilePaymentsSDK

let applicationId = "sq0idp-xxxxxxxxxxxxxxxxxx"
MobilePaymentsSDK.initialize(squareApplicationID: applicationId)

Would appreciate guidance on whether this is a packaging issue with the SDK or an initialization problem on our side.

[brandonjenniges]

@honeykinng345 Can you share what version of the iOS Mobile Payments SDK you are using when seeing this crash?

[honeykinng345]

@brandonjenniges
I am using Flutter, and currently, I am using the following version
square_mobile_payments_sdk: ^2025.7.1

[brandonjenniges]

@honeykinng345 I'm wondering what native version of the SDK you're on. The crash looks like it's in the native SDK and not the plugin. I don't see the crash in our crash logs but it may be because it's happening right during initialization.

• Is this crash happening during some upgrade or after using the SDK for awhile or this is your first time using SquareMobilePaymentsSDK and it's crashing?
• Have you tried uninstalling and re-installing?

[honeykinng345]

We migrated from the Reader SDK to the Mobile Payments SDK, following the implementation guide from Square’s Flutter SDK repository
. We didn’t specify any native SDK version in the Podfile. You’re correct that the issue seems to be related to the initialization process. We also tried uninstalling and reinstalling the app, but that didn’t resolve the problem.

[brandonjenniges]

Thanks for that info. Would you mind trying to update the native SDK version to the newest? And also sharing your applicationId? If you're not comfortable sharing it on here, can you reach out via our support channels at https://developer.squareup.com?

[honeykinng345]

In your doc, you didn't mention that we need to add the native SDK. Can you explain ita little bit more

FYI
This is my pod file

Uncomment this line to define a global platform for your project

platform :ios, '16.0'

CocoaPods analytics sends network stats synchronously affecting flutter build latency.

ENV['COCOAPODS_DISABLE_STATS'] = 'true'

project 'Runner', {
'Debug' => :debug,
'Profile' => :release,
'Release' => :release,
}

Function to get Flutter root directory

def flutter_root
generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), FILE)
unless File.exist?(generated_xcode_build_settings_path)
raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first"
end

File.foreach(generated_xcode_build_settings_path) do |line|
matches = line.match(/FLUTTER_ROOT=(.*)/)
return matches[1].strip if matches
end
raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get"
end

Use the flutter pod helper for configuring iOS build settings

#require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)

flutter_root = File.expand_path('..', File.dirname(which flutter))
require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)

flutter_ios_podfile_setup

target 'Runner' do
use_frameworks!
use_modular_headers!

Zendrive SDK Integration

#pod 'ZendriveSDK', :git => 'https://bitbucket.org/zendrive-root/zendrive_cocoapod.git', :tag => '6.0.0'
pod 'FairmaticSDK', :git => 'https://github.com/fairmatic/fairmatic-cocoapods', :tag => '3.0.0'

Flutter iOS setup

flutter_install_all_ios_pods File.dirname(File.realpath(FILE))

RunnerTests (you can add tests as necessary)

target 'RunnerTests' do
inherit! :search_paths
end
end

Post-install hook to fix frameworks and permissions

post_install do |installer|
installer.pods_project.targets.each do |target|
flutter_additional_ios_build_settings(target)
target.build_configurations.each do |config|
# You can remove unused permissions here
# for more information: https://github.com/BaseflowIT/flutter-permission-handler/blob/master/permission_handler/ios/Classes/PermissionHandlerEnums.h
# e.g. when you don't need camera permission, just add 'PERMISSION_CAMERA=0'
config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
'$(inherited)',
## dart: PermissionGroup.calendar
'PERMISSION_EVENTS=0',
## dart: PermissionGroup.reminders
'PERMISSION_REMINDERS=0',
## dart: PermissionGroup.contacts
'PERMISSION_CONTACTS=0',
## dart: PermissionGroup.camera
'PERMISSION_CAMERA=0',
## dart: PermissionGroup.microphone
'PERMISSION_MICROPHONE=1',
## dart: PermissionGroup.speech
'PERMISSION_SPEECH_RECOGNIZER=0',
## dart: PermissionGroup.photos
'PERMISSION_PHOTOS=1',
## dart: [PermissionGroup.location, PermissionGroup.locationAlways, PermissionGroup.locationWhenInUse]
'PERMISSION_LOCATION=1',
## dart: PermissionGroup.notification
'PERMISSION_NOTIFICATIONS=1',
## dart: PermissionGroup.mediaLibrary
'PERMISSION_MEDIA_LIBRARY=0',
## dart: PermissionGroup.sensors
'PERMISSION_SENSORS=0',
## dart: PermissionGroup.bluetooth
'PERMISSION_BLUETOOTH=1',
## dart: PermissionGroup.appTrackingTransparency
'PERMISSION_APP_TRACKING_TRANSPARENCY=0',
## dart: PermissionGroup.criticalAlerts
'PERMISSION_CRITICAL_ALERTS=0',
]
end
end
end

[brandonjenniges]

In the podspec of the plugin it doesn't specify an exact native SDK version, so you can override in your podfile that you want to use a specific version of the native SDK. You mentioned using both 2025.7.2 and 2025.7.1 of the plugins so am still a bit unsure what native version of the SDK you're using. You can check your Podfile.lock to see what version of the native SDK it ends up using.

[honeykinng345]

I have seen in my Podfile.Lock file, I find the following version.
square_mobile_payments_sdk (0.0.2):

• Flutter
• MockReaderUI (~> 2.2.3)
• SquareMobilePaymentsSDK (~> 2.2.3)

[brandonjenniges]

Ok, I think you can upgrade to 2.2.4 on that plugin version. Can you try that and see if it still crashes? If it does I will need some more information like squareApplicationID and a UTC time stamp of when a crash happened.

[honeykinng345]

I’ve tested it on version 2.2.4 and even tried uninstalling and reinstalling the app, but the issue still persists.

I don’t share my Square Application ID publicly — do you have a Skype ID or another secure channel where I can send it?

I’m also available for a short meeting if you’d prefer to connect and debug this together. The Android version is working perfectly, but the iOS app crashes on launch.

[brandonjenniges]

Can you share it with one of the admins in our discord or pst in #questions channel?

Just to make sure, because this seems like it should be very reproducible if all you're doing is calling MobilePaymentsSDK.initialize(squareApplicationID: applicationId):

• Does this crash happen for both staging and production application ids?
• Could you make another application id and test if it crashes?
• Can you also replicate this in a fresh test app?
• Do you still have Reader SDK being initialized, if so can you make it so it doesn't initialize anymore

[brandonjenniges]

Closing, @honeykinng345 please reach out to our developer support on discord if you're still having issues with this.

[honeykinng345]

@brandonjenniges
App crashes on launch when initializing Mobile Payments SDK — “Unable to find an entity with name 'TIPPTippingPreferences'” (conflict with FairmaticSDK)

I’m facing a crash on app launch when using the Square Mobile Payments SDK together with FairmaticSDK.

When I include the following pod in my Podfile:
pod 'FairmaticSDK',
:git => 'https://github.com/fairmatic/fairmatic-cocoapods',
:tag => '3.0.0',
:modular_headers => false
the app immediately crashes on launch with this exception:
Unable to find an entity with name 'TIPPTippingPreferences'
his happens during the initialization of Mobile Payments SDK.
If I comment out the FairmaticSDK pod, the app builds and runs without any crash.

It looks like there is a conflict or CoreData model name collision between the two SDKs.

Environment

iOS

CocoaPods

Mobile Payments SDK version: (your version here)

FairmaticSDK version: 3.0.0

Steps to Reproduce

Add both Mobile Payments SDK and FairmaticSDK to Podfile.

Run pod install.

Launch the app.

Crash occurs immediately on initialization.

Expected Behavior

Both SDKs should work together without any conflicts or crashes.

Actual Behavior

App crashes on launch with the error:
Unable to find an entity with name 'TIPPTippingPreferences'.

[brandonjenniges]

Thanks for that info! Am able to replicate, will try to understand what's happening.