For the complete documentation index, see llms.txt. This page is also available as Markdown.

pin_cashback

Description

For Chip cards

Customer will be prompted for an online or an offline PIN based on the EMV CVM rules.

For Contactless cards

Customer will be prompted for an online PIN for contactless cards according to the Contactless rules

For Manual/MSR

Customer will be prompted for an online PIN according to the configuration as documented below

Customer is prompted to enter PIN. PIN is never in clear in Android. Even though Android displays the screen, the touch is controlled by the secure processor. The PIN entry screen is displayed for online and offline PIN entry.

Merchant/Customer action

Customer enters the PIN.

Configuration Parameters

ContactAIDS.DomesticPinBypassEnabled - For chip and contactless cards, the customer is allowed to bypass the PIN by tapping Enter if the card is a domestic card and if this is enabled.

ContactAIDS.InternationalPinBypassEnabled - For chip and contactless cards, the customer is allowed to bypass the PIN by tapping Enter if the card is an international card and if this is enabled.

Products.MsrPinPrompt - If this is enabled for the product corresponding to the swiped card, the PIN will be prompted.

Products.ManualPinPrompt - If this is enabled for the product corresponding to the manually entered card, the PIN will be prompted (except for MOTO).

PIN will not be prompted if this is a MOTO Transaction.

Terminal.DisplayCardBrandDuringTransaction - When enabled, the card brand logo and application preferred name will be displayed.

Error Scenarios

If PIN bypass is not enabled, the Enter key is not enabled until 4 digits are entered

if the customer enters PIN wrong for offline PIN, the customer is prompted for PIN again

If the customer enters wrong PIN for offline PIN entry and the PIN entry retries are exhausted, the transaction is declined and the card is blocked.

If the customer enters wrong PIN for online PIN and if the host requests PIN retry, the customer is prompted for PIN again

If the customer removes chip card before completing the PIN entry, the transaction is cancelled

If the PIN entry times out, the customer will be asked to remove the card if this is a chip card and payment not completed message will be shown

If the customer taps “Cancel”, the customer will be asked to remove card and payment not completed message will be shown

If the device crashes or device reboots while in PIN entry screen, when the payment application restarts or device boots up , the power failure recovery will happen

---

Last updated

Was this helpful?