Contact Stripe support to enable this feature on your account.
Global card saving after payment support by updating customer consent capture. The following breaking changes are required:
A valid allowRedisplay value is now required to be set in collectConfiguration when using setupFutureUsage for SCPTerminal's collectPaymentMethod.
Removed the customerConsentCollected parameter from SCPTerminal's collectSetupIntentPaymentMethod and replaced it with allowRedisplay.
⚠️ Breaking changes required
Reader discovery
New: Added a new enum value discovering to SCPConnectionStatus to represent when discovery is running.
Update: Subsequent calls to SCPTerminal's discoverReaders:delegate:completion: cancel all previously queued discovery operations. Only one discovery operation can run at any given time; all other discovery attempts will fail with SCPErrorCanceledDueToIntegrationError.
Update: Internet and Tap to Pay discovery will now call the discoverReaders completion block when the operation completes since these are not long running discovery operations.
Reader connection
Update: There is now a single connectReader call used for all connection methods. This replaces the previous methods: connectBluetoothReader, connectInternetReader, and connectLocalMobileReader.
For mobile readers and Tap to Pay readers, the ReaderDelegate has been removed from the connectReader method as a parameter, and moved into the connectionConfig, replacing autoReconnectionDelegate. - For smart readers, the InternetConnectionConfiguration now also expects an InternetReaderDelegate to be passed in, which will alert your integration of reader disconnects.
The SCPReconnectionDelegate has been removed and the methods have been moved to the common ReaderDelegate.
Update: The method for handling reader disconnects has changed.
Removed terminal:didReportUnexpectedReaderDisconnect: from the SCPTerminalDelegate. Use reader:didDisconnect: to be informed of reader disconnects.
When auto-reconnect on unexpected disconnect is enabled, both -readerDidFailReconnect: and reader:didDisconnect: methods will be called if the SDK fails to reconnect to the reader and it becomes disconnected.
Payment acceptance
New: Added a new enum value SCPCardPresentCaptureMethodManual to SCPCardPresentCaptureMethod for simplifying manual card capture without affecting automatic non-card payment capture.
Update: SCPTerminal's confirmPaymentIntent:completion, confirmSetupIntent:completion, and confirmRefund:completion operations now return SCPCancelable's that allow you to cancel the operation in certain scenarios.
Update: Calls to SCPTerminal's cancelPaymentIntent:completion or cancelSetupIntent:completion will now cancel ongoing operations related to the specified intent.
Update: SCPPaymentIntentParameters and SCPSetupIntentParameters now keep payment method types as values of the SCPPaymentMethodType enum rather than strings.
Update: SCPSetupIntent.stripeId is now nullable to be consistent with SCPPaymentintent.stripeId. The SCPSetupIntent.stripeId will continue to be present.
Update: In SCPReaderSoftwareUpdate, renamed estimatedUpdateTime to durationEstimate.
Update: Renamed SCPUpdateTimeEstimate to SCPUpdateDurationEstimate.
Update: Renamed "local mobile" and "apple built in" to "Tap To Pay" in all SDK types, function names, and error codes to align with Stripe branding for this functionality.
Non-breaking changes
Update: The SCPInternetDiscoveryConfiguration now supports an optional timeout value, specifying the timeout in seconds for the discover readers request. If the online discovery attempt fails, the operation will automatically fall back to offline discovery if offline mode is enabled.
Update: Improved accuracy of smart reader errors that are reported as SCPError. Errors that were previously reported as a SCPErrorGenericReaderError are now mapped to a more specific SCPError type.
4.0.0 includes breaking changes in both symbols and behavior. See the migration guide for more details.
New Features
Mail order / telephone order (MOTO) payment support for smart readers.
Global card saving after payment support by updating customer consent capture. The following breaking changes are required:
allowRedisplayvalue is now required to be set incollectConfigurationwhen usingsetupFutureUsageforSCPTerminal'scollectPaymentMethod.customerConsentCollectedparameter fromSCPTerminal'scollectSetupIntentPaymentMethodand replaced it withallowRedisplay.⚠️ Breaking changes required
Reader discovery
discoveringtoSCPConnectionStatusto represent when discovery is running.SCPTerminal'sdiscoverReaders:delegate:completion:cancel all previously queued discovery operations. Only one discovery operation can run at any given time; all other discovery attempts will fail withSCPErrorCanceledDueToIntegrationError.discoverReaderscompletion block when the operation completes since these are not long running discovery operations.Reader connection
Update: There is now a single
connectReadercall used for all connection methods. This replaces the previous methods:connectBluetoothReader,connectInternetReader, andconnectLocalMobileReader.ReaderDelegatehas been removed from theconnectReadermethod as a parameter, and moved into theconnectionConfig, replacingautoReconnectionDelegate. - For smart readers, theInternetConnectionConfigurationnow also expects anInternetReaderDelegateto be passed in, which will alert your integration of reader disconnects.Update: Auto reconnect on unexpected disconnect is now enabled by default for mobile and Tap to Pay readers.
SCPReconnectionDelegatehas been removed and the methods have been moved to the commonReaderDelegate.Update: The method for handling reader disconnects has changed.
terminal:didReportUnexpectedReaderDisconnect:from theSCPTerminalDelegate. Usereader:didDisconnect:to be informed of reader disconnects.-readerDidFailReconnect:andreader:didDisconnect:methods will be called if the SDK fails to reconnect to the reader and it becomes disconnected.Payment acceptance
SCPCardPresentCaptureMethodManualtoSCPCardPresentCaptureMethodfor simplifying manual card capture without affecting automatic non-card payment capture.SCPTerminal'sconfirmPaymentIntent:completion,confirmSetupIntent:completion, andconfirmRefund:completionoperations now returnSCPCancelable's that allow you to cancel the operation in certain scenarios.SCPTerminal'scancelPaymentIntent:completionorcancelSetupIntent:completionwill now cancel ongoing operations related to the specified intent.SCPOfflineDelegatenow conforms toNSObject.SCPPaymentIntentParametersandSCPSetupIntentParametersnow keep payment method types as values of theSCPPaymentMethodTypeenum rather than strings.SCPSetupIntent.stripeIdis nownullableto be consistent withSCPPaymentintent.stripeId. TheSCPSetupIntent.stripeIdwill continue to be present.Renaming
BluetoothReaderDelegatehas been renamed toMobileReaderDelegate.SCPReaderSoftwareUpdate, renamedestimatedUpdateTimetodurationEstimate.SCPUpdateTimeEstimatetoSCPUpdateDurationEstimate.Non-breaking changes
SCPInternetDiscoveryConfigurationnow supports an optionaltimeoutvalue, specifying the timeout in seconds for the discover readers request. If the online discovery attempt fails, the operation will automatically fall back to offline discovery if offline mode is enabled.SCPError. Errors that were previously reported as aSCPErrorGenericReaderErrorare now mapped to a more specificSCPErrortype.