MPI Extensibility

1 min

We have exposed the underlying MiuraSDK (which the ToroSDK depends on) to allow consuming apps to interact with Miura devices.

For example, if you wanted to show a custom gratuity menu before a transaction, you could show the menu before calling toro.startTransaction() and add the tip amount in the TransactionMetadata object. See more about gratuities here.

import MiuraSDK
import SwiftUI
import ToroSDK

enum MiuraDevice {

    static func showTipMenu(
        toro: ToroClient,
        completion: @escaping (Result<Int, ToroError>) -> Void
    ) {
        let miura = MiuraManager.sharedInstance()

        let tipOptions = [
            (text: "1. 5%", percentage: 5),
            (text: "2. 10%", percentage: 10),
            (text: "3. 15%", percentage: 15),
            (text: "4. 20%", percentage: 20),
        ]

        let menuItems = tipOptions.map { $0.text }

        toro.openSession { _ in
            miura.getMenuOption(
                "My Wonderful Tip Menu!",
                showStatusBar: false,
                enlargeHeader: true,
                enlargeFooter: false,
                menuItems: menuItems
            ) { result, value in
                switch result {
                case .cancelled:
                    completion(.failure(ToroError.customerCancelled))
                case .selected:
                    guard let selectedValue = value,
                        let index = menuItems.firstIndex(of: selectedValue)
                    else {
                        completion(
                            .failure(
                                ToroError.unknownError("Invalid tip selection"))
                        )
                        return
                    }
                    let tipPercentage = tipOptions[index].percentage
                    completion(.success(tipPercentage))
                case .timeout:
                    completion(.failure(ToroError.transactionTimeout))
                case .error:
                    completion(
                        .failure(
                            ToroError.deviceError(
                                "Device returned error response when getting tip"
                            )))
                @unknown default:
                    completion(
                        .failure(ToroError.unknownError("Unknown menu result")))
                }

                toro.closeSession()
            }
        }
    }
}

Note that we recommend using the ToroSDK methods to open and close sessions with the selected device. You could use the MiuraSDK directly to do this, but managing the session via ToroSDK means that the SDK maintains visibility over the device connection state. While there isn't a strict technical requirement for this approach currently, it provides better integration with the SDK's internal state management and ensures compatibility with future SDK updates that may rely on this session tracking.