Magtek IPAD, Programmer'S Reference Manual

Page: 31 / 75

3 - MTPPSCRAPCL Functions
IPAD, DynaPro, DynaPro Go, and DynaPro Mini| PIN Encryption Devices | Programmer’s Reference (Microsoft Windows Store)
Page 31
3.41 requestSignature
This function sends the Request Signature report to the device. The device will prompt the user to sign.
The event associated with this command is
OnSignatureArrive .
int requestSignature(
int waitTime,
int beepTones,
int option);
Parameter Description
waitTime Time the device should wait for the user to begin signing
beepTones Tone to use:
0 - None
1 - Single Beep
2 - Double Beep
option Option to verify or not to verify the PIN:
0 – Timeout to clean data
1 – Timeout with available data, signature can retrieved if exists
Return Value:
Returns a value (0: Success, Non-Zero: Error)
3.42 requestSmartCard
This function wraps device command
0xA2
. It directs the device to prompt the user to confirm the
transaction amount, and to arm the MSR and / or contact ICC reader to wait for a card to be swiped or
presented into the contact ICC connector. If armed to read a contact ICC, the device will turn on the LED
near the smart card connector after the cardholder confirms the transaction amount. The host should abort
the transaction if the user presses the CANCEL button.
If there are no errors, the device will prompt the user to approve an amount and swipe or insert card by
displaying pre-determined EMV messages.
The LCD display will cycle showing “(AMOUNT),” “(AMOUNT) OK?” and “CANCEL OR ENTER,”
and will wait for the cardholder to push either the confirmation or cancellation button.
If the cardholder presses the confirmation button, then depending on the card type requested to be read,
the LCD display will show either SWIPE or INSERT CARD. If the user presses the cancellation button
or the transaction times out, the device will perform the command completion action.
If the cardholder has inserted an ICC card, and if the Acquirer has set the device’s payment brand account
type setting for ICC to
Debit or Credit , the device will prompt the cardholder to select debit or credit.
Per EMV 4.x requirements, if the cardholder uses the MSR input, the device will check the service code
from the magnetic stripe data to see if it begins with a 2 or a 6 to determine if the card also includes an
ICC, and will advise the cardholder that ICC is preferred by displaying USE CHIP READER. If the ICC
fails or the service code does not begin with a 2 or a 6, the device will prompt the cardholder for an MSR
swipe. After a successful swipe, the device will prompt the user to select debit or credit. If this is a debit
account type, the device will request a PIN.