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.