SCPReaderDisplayDelegate

Objective-C

@protocol SCPReaderDisplayDelegate <NSObject>

Swift

protocol ReaderDisplayDelegate : NSObjectProtocol

You must implement this protocol to handle displaying events when connected to a bluetooth reader (e.g., the BBPOS Chipper 2X BT or BBPOS WisePad 3).

The Verifone P400 has a built-in display, which handles displaying card and payment events to the customer. The Stripe Terminal iOS SDK will not call SCPReaderDisplayDelegate methods while connected to the Verifone P400.

If you implement this protocol, the object that implements this protocol should get passed into [SCPTerminal collectPaymentMethod:delegate:completion] or [SCPTerminal readReusableCard:delegate:completion].

  • 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.