{"title":"Create the tender","category":"default","creationDate":1776961627,"content":"<h2 id=\"peddevice-object\">PedDevice Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>PedDevice<\/code><\/td>\n<td>PED object that represents the terminal.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"method\">Method<\/h2>\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>CreateTender<\/code><\/td>\n<td>Use this method to start the transaction.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"sc-notice warning\"><div>\n<p>For gift card operations, you create a tender prior to calling <code>GiftCardRedeem<\/code>. This <code>CreateTender<\/code> must not include a <code>KeyedEntry<\/code> tender option.\u00a0If the original tender contains a <code>KeyedEntry<\/code> tender option, it is not possible to perform a <code>GiftCardRedeem<\/code>.<\/p>\n<\/div><\/div>\n<h2 id=\"parameters\">Parameters<\/h2>\n<table style=\"width:100%;\"><colgroup><col style=\"width: 22%\"><col style=\"width: 10%\"><col style=\"width: 7%\"><col style=\"width: 60%\"><\/colgroup><thead><tr class=\"header\"><th><p>Name<\/p><\/th><th><p>Type<\/p><\/th><th><p>Required<\/p><\/th><th><p>Description<\/p><\/th><\/tr><\/thead><tbody><tr><td>\n<p><code>merchantAccount<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The merchant account that will receive the payment.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>amountValue<\/code><\/p>\n<\/td><td>\n<p>Long<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The transaction amount in minor units (100 is 1.00 with EUR).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>amountCurrency<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The transaction currency.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>transactionType<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The type of transaction, for example: GOODS_SERVICES, REFUND.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>tenderOptions<\/code><\/p>\n<\/td><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/com-extension-for-windows-objects\/tenderoption\">TenderOption<\/a><\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The transaction options. Can be an empty <code>TenderOption<\/code>.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>merchantRef<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The transaction reference provided by the merchant (reported in the plataforma de pagamentos da Adyen).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>orderRef<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The order reference for split payments (reported in the plataforma de pagamentos da Adyen).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>gratuityAmountValue<\/code><\/p>\n<\/td><td>\n<p>int<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The tender gratuity amount in minor units (100 is 1.00 with EUR).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>gratuityAmountCurrency<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>The tender gratuity currency.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>shopperEmail<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Shopper identification (used for omnichannel digital customer recognition).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>shopperRef<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Shopper identification (used for omnichannel digital customer recognition).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>recurringContract<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Recurring contract if registering for RECURRING or ONECLICK payments.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>recurringContractDetailName<\/code><\/p>\n<\/td><td>\n<p>String<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Recurring contract detail key (points at payment details of this Tender).<\/p>\n<\/td><\/tr><tr><td>\n<p><code>additionalData<\/code><\/p>\n<\/td><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/com-extension-for-windows-objects\/additionaldata\">AdditionalData<\/a><\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Additional data the method passes with the tender. The\u00a0 <code>AdditionalData<\/code> \u00a0object is a generic container that can hold extra fields. The system uses the card number as a key to collect relevant additional data, for example loyalty data or recurring contract information.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n<div class=\"sc-notice note\"><div>\n<p>Not all languages using COM handle empty parameters equally. This has the potential to cause unexpected behavior. To prevent this, provide empty strings or pass <code>Null<\/code> objects for C++\/C#, and the default value <code>Nothing<\/code> for VB.NET.<\/p>\n<\/div><\/div>\n<h2 id=\"callbacks\">Callbacks<\/h2>\n<table><colgroup><col style=\"width: 22%\"><col style=\"width: 77%\"><\/colgroup><thead><tr class=\"header\"><th><p>Name<\/p><\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>\n<p>CreateTenderCB<\/p>\n<\/td><td>\n<p>Immediate callback to tender creation.<\/p>\n<\/td><\/tr><tr><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/handle-progress-events-com-extension\">Progress Event Callback<\/a><\/p>\n<\/td><td>\n<p>Reports the progress of a running tender.<\/p>\n<\/td><\/tr><tr><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/handle-the-additional-data-callback-com-extension\">Additional Data Callback<\/a><\/p>\n<\/td><td>\n<p>Invoked after the shopper inserts or swipes a card. Retrieves additional data about the cardholder.<\/p>\n<\/td><\/tr><tr><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/extras-com-extension\/handle-dynamic-currency-conversion-com-extension\">DCC Callback<\/a><\/p>\n<\/td><td>\n<p>Returns dynamic currency conversion information to inform the POS what is happening on the PED. On the PED the shopper is allowed to choose their own currency to complete the tender.<\/p>\n<\/td><\/tr><tr><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/handle-the-print-receipt-callback-com-extension\">PrintReceipt Callback<\/a><\/p>\n<\/td><td>\n<p>Returns the receipt for printing, and requests that the POS confirms it has received the receipt.<\/p>\n<\/td><\/tr><tr><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/handle-the-signature-callback-com-extension\">Signature Callback<\/a><\/p>\n<\/td><td>\n<p>Allows the store assistant to accept or decline a shopper's signature on the PED.<\/p>\n<\/td><\/tr><tr><td>\n<p><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/handle-the-final-state-callback-com-extension\">Final Callback<\/a><\/p>\n<\/td><td>\n<p>When the plataforma de pagamentos da Adyen finishes processing the tender, it triggers the final state callback.<\/p>\n<\/td><\/tr><\/tbody><\/table>","url":"https:\/\/docs.adyen.com\/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\/create-the-tender-com-extension","articleFields":{"id":"25143509","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\/key-steps-com-extension\/process-a-basic-transaction-com-extension\/create-the-tender-com-extension","title":"Create the tender","content":"PedDevice Object\n\n\n\nName\nDescription\n\n\n\n\nPedDevice\nPED object that represents the terminal.\n\n\n\nMethod\n\n\n\nName\nDescription\n\n\n\n\nCreateTender\nUse this method to start the transaction.\n\n\n\n\nFor gift card operations, you create a tender prior to calling GiftCardRedeem. This CreateTender must not include a KeyedEntry tender option.\u00a0If the original tender contains a KeyedEntry tender option, it is not possible to perform a GiftCardRedeem.\n\nParameters\nNameTypeRequiredDescription\nmerchantAccount\n\nString\n\n\n\nThe merchant account that will receive the payment.\n\namountValue\n\nLong\n\n\n\nThe transaction amount in minor units (100 is 1.00 with EUR).\n\namountCurrency\n\nString\n\n\n\nThe transaction currency.\n\ntransactionType\n\nString\n\n\n\nThe type of transaction, for example: GOODS_SERVICES, REFUND.\n\ntenderOptions\n\nTenderOption\n\n\n\nThe transaction options. Can be an empty TenderOption.\n\nmerchantRef\n\nString\n\n\n\nThe transaction reference provided by the merchant (reported in the plataforma de pagamentos da Adyen).\n\norderRef\n\nString\n\n\n\nThe order reference for split payments (reported in the plataforma de pagamentos da Adyen).\n\ngratuityAmountValue\n\nint\n\n\n\nThe tender gratuity amount in minor units (100 is 1.00 with EUR).\n\ngratuityAmountCurrency\n\nString\n\n\n\nThe tender gratuity currency.\n\nshopperEmail\n\nString\n\n\n\nShopper identification (used for omnichannel digital customer recognition).\n\nshopperRef\n\nString\n\n\n\nShopper identification (used for omnichannel digital customer recognition).\n\nrecurringContract\n\nString\n\n\n\nRecurring contract if registering for RECURRING or ONECLICK payments.\n\nrecurringContractDetailName\n\nString\n\n\n\nRecurring contract detail key (points at payment details of this Tender).\n\nadditionalData\n\nAdditionalData\n\n\n\nAdditional data the method passes with the tender. The\u00a0 AdditionalData \u00a0object is a generic container that can hold extra fields. The system uses the card number as a key to collect relevant additional data, for example loyalty data or recurring contract information.\n\n\nNot all languages using COM handle empty parameters equally. This has the potential to cause unexpected behavior. To prevent this, provide empty strings or pass Null objects for C++\/C#, and the default value Nothing for VB.NET.\n\nCallbacks\nNameDescription\nCreateTenderCB\n\nImmediate callback to tender creation.\n\nProgress Event Callback\n\nReports the progress of a running tender.\n\nAdditional Data Callback\n\nInvoked after the shopper inserts or swipes a card. Retrieves additional data about the cardholder.\n\nDCC Callback\n\nReturns dynamic currency conversion information to inform the POS what is happening on the PED. On the PED the shopper is allowed to choose their own currency to complete the tender.\n\nPrintReceipt Callback\n\nReturns the receipt for printing, and requests that the POS confirms it has received the receipt.\n\nSignature Callback\n\nAllows the store assistant to accept or decline a shopper's signature on the PED.\n\nFinal Callback\n\nWhen the plataforma de pagamentos da Adyen finishes processing the tender, it triggers the final state callback.\n","type":"page","locale":"pt","boost":13,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"COM extension for Windows integration","lvl5":"Key steps","lvl6":"Process a basic transaction","lvl7":"Create the tender"},"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\/key-steps-com-extension","lvl6":"https:\/\/docs.adyen.com\/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","lvl7":"\/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\/create-the-tender-com-extension"},"levels":8,"category":"In-person payments","category_color":"green","tags":["Create","tender"]}}