# pin

{% columns %}
{% column width="33%" %}
![](/files/DF5ypin6rfW4Iu6WZmWG)\
![](/files/30aSFODSUEEBxjMb5JA6)\
![](/files/YFENK7eT16my5DTMOoES)
{% endcolumn %}

{% column %}
**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).

`Products.MsrPinByPass` - If this is enabled for the product corresponding to the swiped card, PIN bypass will be allowed.

`Products.ManualPinByPass` - If this is enabled for the product corresponding to the manually entered card, the PIN bypass will be allowed (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.

`Merchant.AlphanumericKeys` - Shows/hides letters in the keys.

Disabled\\

0: Hides letters below number keys.

Enabled\\

1: Shows letters below number keys.

\
**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
{% endcolumn %}
{% endcolumns %}

\---


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verifone.com/functional-specification/pin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.