SCPReaderDisplayDelegate

@protocol SCPReaderDisplayDelegate <NSObject>

You must implement this protocol to handle displaying events when connected to a reader without a built-in display (e.g., the BBPOS Chipper 2X BT).

  • This method is called when the reader begins waiting for input. Your app should prompt the customer to present a payment method using one of the given input options. If the reader emits a prompt, the didRequestReaderDisplayMessage method will be called.

    Use stringFromReaderInputOptions to get a user facing string for the input options.

    Declaration

    Objective-C

    - (void)terminal:(nonnull SCPTerminal *)terminal
        didRequestReaderInput:(SCPReaderInputOptions)inputOptions;

    Swift

    func terminal(_ terminal: SCPTerminal, didRequestReaderInput inputOptions: ReaderInputOptions = [])

    Parameters

    terminal

    The originating terminal.

    inputOptions

    The armed input options on the reader.

  • This method is called to request that a prompt be displayed in your app. For example, if the prompt is SwipeCard, your app should instruct the user to present the card again by swiping it.

    Use stringFromReaderDisplayMessage to get a user facing string for the prompt.

    See

    SCPReaderDisplayMessage

    Declaration

    Objective-C

    - (void)terminal:(nonnull SCPTerminal *)terminal
        didRequestReaderDisplayMessage:(SCPReaderDisplayMessage)displayMessage;

    Swift

    func terminal(_ terminal: SCPTerminal, didRequestReaderDisplayMessage displayMessage: ReaderDisplayMessage)

    Parameters

    terminal

    The originating terminal.

    displayMessage

    The message to display to the user.