{"title":"TenderOption","category":"default","creationDate":1776961627,"content":"<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>TenderOption<\/td>\n<td>Represents tender options that are passed with the tender. Create the object using <code>CreateTenderOptionObj<\/code> method from the <code>PedDevice<\/code> object.\u00a0Generally, transaction options can be configured\u00a0via the Adyen Customer Area (CA) or as a\u00a0<code>TenderOption<\/code>\u00a0on a per-transaction basis.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Tender options define the behavior of the PED.<\/p>\n<p>An object of type <code>TENDER_OPTIONS<\/code> that can have the following values:<\/p>\n<table><thead><tr class=\"header\"><th>Name<\/th><th>Description<\/th><\/tr><\/thead><tbody>\n<tr><td><code>AllowPartialAuthorisation<\/code><\/td><td>Flags that a partial approval is allowed. As a result, the authorized amount might be lower than the requested amount.<\/td><\/tr>\n<tr><td><code>AskCharity<\/code><\/td><td>Triggers the terminal to ask if the shopper wants to donate to charity.<\/td><\/tr>\n<tr><td><code>AskGratuity<\/code><\/td><td>Triggers the terminal to ask if the shopper wants to tip.<\/td><\/tr>\n<tr><td><code>BypassPin<\/code><\/td><td><p>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.<\/p><p>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.<\/p><p>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.<\/p><\/td><\/tr>\n<tr><td><code>DontPrintReceipt<\/code><\/td><td>Specifies that no receipt should be printed.<\/td><\/tr>\n<tr><td><code>EnableMagstripeFallback<\/code><\/td><td>If 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.<\/td><\/tr>\n<tr><td><code>ForcedDecline<\/code><\/td><td>Forces a decline of the transaction, for example, if fraud is suspected.<\/td><\/tr>\n<tr><td><code>ForcedOnline<\/code><\/td><td><p>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.<\/p><\/td><\/tr>\n<tr><td><code>GetAdditionalData<\/code><\/td><td>Gathers 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.<\/td><\/tr>\n<tr><td><code>KeyedEntry<\/code><\/td><td><p>Triggers MKE processing. If set to true, this requires the merchant or cardholder to enter the card number manually. Used for damaged cards.<\/p><div class=\"sc-notice warning\"><div><p>For gift card operations, the tender created before redemption must not include a <code>KeyedEntry<\/code> tender option.\u00a0If the original tender contains the <code>KeyedEntry<\/code> tender option, it is not possible to update the tender to a gift card redemption.<\/p><\/div><\/div><\/td><\/tr>\n<tr><td><code>MOTO<\/code><\/td><td><p>Triggers MOTO transactions on the payment terminal from the POS system. MOTO transactions are\u00a0<a href=\"\/get-started-with-adyen\/adyen-glossary\/#card-not-present-cnp\">card-not-present transactions<\/a>, where the payment details are presented to a\u00a0<a href=\"\/get-started-with-adyen\/adyen-glossary\/#merchant\">merchant<\/a>\u00a0by a\u00a0<a href=\"\/get-started-with-adyen\/adyen-glossary\/#shopper\">shopper<\/a>\u00a0by means of mail (not email), fax, or telephone.<\/p><\/td><\/tr>\n<tr><td><code>NoCTLS<\/code><\/td><td>Disables contactless\/NFC as entry mode for the transaction.<\/td><\/tr>\n<tr><td><code>ReceiptHandler<\/code><\/td><td>Specifies 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.<\/td><\/tr>\n<tr><td><code>SkipAIDPriority<\/code><\/td><td>Skip a card's application identifier (AID) priority. This allows a shopper to select their preferred card application.<\/td><\/tr><\/tbody><\/table>\n<p>This object is used in the following call to represent tender options:<\/p>\n<ul>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/pass-tender-options-com-extension\">Pass tender options - COM extension<\/a><\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/com-extension-for-windows-objects\/tenderoption","articleFields":{"id":"25143543","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/com-extension-for-windows-objects\/tenderoption","title":"TenderOption","content":"\n\n\nName\nDescription\n\n\n\n\nTenderOption\nRepresents tender options that are passed with the tender. Create the object using CreateTenderOptionObj method from the PedDevice object.\u00a0Generally, transaction options can be configured\u00a0via the Adyen Customer Area (CA) or as a\u00a0TenderOption\u00a0on a per-transaction basis.\n\n\n\nTender options define the behavior of the PED.\nAn object of type TENDER_OPTIONS that can have the following values:\nNameDescription\nAllowPartialAuthorisationFlags that a partial approval is allowed. As a result, the authorized amount might be lower than the requested amount.\nAskCharityTriggers the terminal to ask if the shopper wants to donate to charity.\nAskGratuityTriggers the terminal to ask if the shopper wants to tip.\nBypassPinBypasses 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.\nDontPrintReceiptSpecifies that no receipt should be printed.\nEnableMagstripeFallbackIf 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.\nForcedDeclineForces a decline of the transaction, for example, if fraud is suspected.\nForcedOnlineForces 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.\nGetAdditionalDataGathers 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.\nKeyedEntryTriggers 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.\u00a0If the original tender contains the KeyedEntry tender option, it is not possible to update the tender to a gift card redemption.\nMOTOTriggers MOTO transactions on the payment terminal from the POS system. MOTO transactions are\u00a0card-not-present transactions, where the payment details are presented to a\u00a0merchant\u00a0by a\u00a0shopper\u00a0by means of mail (not email), fax, or telephone.\nNoCTLSDisables contactless\/NFC as entry mode for the transaction.\nReceiptHandlerSpecifies 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.\nSkipAIDPrioritySkip a card's application identifier (AID) priority. This allows a shopper to select their preferred card application.\nThis object is used in the following call to represent tender options:\n\nPass tender options - COM extension\n","type":"page","locale":"pt","boost":14,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"COM extension for Windows integration","lvl5":"COM Extension for Windows - Objects","lvl6":"TenderOption"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations","lvl4":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration","lvl5":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/com-extension-for-windows-objects","lvl6":"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/com-extension-for-windows-objects\/tenderoption"},"levels":7,"category":"In-person payments","category_color":"green","tags":["TenderOption"]}}
