Terminal-2 icon

TenderOption

Name Description
TenderOption Represents tender options that are passed with the tender. Create the object using CreateTenderOptionObj method from the PedDevice object. Generally, transaction options can be configured via the Adyen Customer Area (CA) or as a TenderOption on a per-transaction basis.

Tender options define the behavior of the PED.

An object of type TENDER_OPTIONS that can have the following values:

NameDescription
AllowPartialAuthorisationFlags that a partial approval is allowed. As a result, the authorized amount might be lower than the requested amount.
AskCharityTriggers the terminal to ask if the shopper wants to donate to charity.
AskGratuityTriggers the terminal to ask if the shopper wants to tip.
BypassPin

Bypasses PIN entry where the shopper does not know the PIN for the card and the Merchant either knows they are the legitimate cardholder or wants to give them the benefit of the doubt.

Requires that the shopper indicates the PIN is not known. The staff cancel the existing transaction and initiate a new transaction through the POS system. They then ask the shopper to press Enter when prompted for a PIN. Subsequently the shopper will need to provide a signature. The Merchant then needs to check the signature and approve it.

As a cardholder is expected to know the PIN for the card issued, verifying of the signature as well as cardholder name with some form of identification is recommended.

DontPrintReceiptSpecifies that no receipt should be printed.
EnableMagstripeFallbackIf ICC cannot be processed, magstripe will be used as the point-of-sale entry mode. If magstripe is disabled in your configuration, use this tender option to enable it for a transaction.
ForcedDeclineForces a decline of the transaction, for example, if fraud is suspected.
ForcedOnline

Forces online authorization of the transaction. Should only be used in exceptional cases. The terminal tries to process online by default, and if that is not possible, it checks the configured limits to determine if the transaction can be processed offline.

GetAdditionalDataGathers and makes available additional data, after a card is read. The amount of the transaction can be changed based on additional input from the POS system. Used for Dynamic Currency Conversion and shopper recognition (for example, to offer discounts to loyal customers). To use these features, you need to contact Support for back end configuration.
KeyedEntry

Triggers MKE processing. If set to true, this requires the merchant or cardholder to enter the card number manually. Used for damaged cards.

For gift card operations, the tender created before redemption must not include a KeyedEntry tender option. If the original tender contains the KeyedEntry tender option, it is not possible to update the tender to a gift card redemption.

MOTO

Triggers MOTO transactions on the payment terminal from the POS system. MOTO transactions are card-not-present transactions, where the payment details are presented to a merchant by a shopper by means of mail (not email), fax, or telephone.

NoCTLSDisables contactless/NFC as entry mode for the transaction.
ReceiptHandlerSpecifies that the POS system handles and prints receipts. If omitted, it is required that the payment terminal prints the receipt. If there is no printer unit, the transaction will fail.
SkipAIDPrioritySkip a card's application identifier (AID) priority. This allows a shopper to select their preferred card application.

This object is used in the following call to represent tender options: