5.8.0

New

• Added support for reading and setting the buzzer volume on supported readers.
  • Read the current volume from SCPReaderSettings.buzzerVolume via retrieveReaderSettings:. SCPReaderBuzzerVolume reports the current and maximum volume.
  • Set the volume by calling setReaderSettings:completion: with SCPBuzzerVolumeParameters, using init(level:) for Low or High, or init(volume:) for a custom volume in the range 1...maxVolume.
  • On a connected reader that does not support buzzer volume control, the volume is reported as unavailable and setReaderSettings: fails.
• Added generatedCardExpanded property to SCPSetupAttemptCardPresentDetails, exposing the full SCPPaymentMethod object when saving a card via SetupIntent. Fixes #392.
• Added paymentMethodExpanded property to SCPSetupIntent, exposing the full SCPPaymentMethod object attached to the SetupIntent.
• Added SCPLogLevelError, SCPLogLevelWarning, and SCPLogLevelInfo to SCPLogLevel, matching the granularity available in the Android SDK. Setting a level now prints logs at that severity and above, rather than all-or-nothing.
• Added SCPErrorPrinterLowBattery error code. This error is returned when the reader's battery is too low to complete a print operation.
• Added SCPDeviceTypeUnknown (DeviceType.unknown). A reader whose device_type this version of the SDK does not recognize is now surfaced with this device type instead of being omitted, mirroring the Android SDK. The SDK exposes no known capabilities for a reader of this type.

Fixes

• Fixed inaccurate SCPDisconnectReason values reported for mobile readers connecting over Bluetooth, such as the Stripe Reader M2. A Bluetooth signal loss corroborated by the OS as an out-of-range link timeout is now reported as SCPDisconnectReasonBluetoothSignalLost, selecting "Forget this device" in iOS Settings is now reported as SCPDisconnectReasonPeerRemovedPairingInformation, and an unexpected internal disconnect is no longer misreported as SCPDisconnectReasonDisconnectRequested. Fixes #391.
• Fixed a crash during Tap to Pay on iPhone collectPaymentMethod when the connected reader or reader account ID was unexpectedly unavailable. Fixes #395.