{"title":"Create the tender","category":"default","creationDate":1776961627,"content":"

Class<\/h2>\n<\/colgroup>
Name<\/th>Description<\/th><\/tr><\/thead>
\n

MerchantPed<\/code><\/p>\n<\/td>

\n

Extends\u00a0 AdyenPed<\/code>.\u00a0 Class used to implement all PIN entry device (PED) functionality.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

Method<\/h2>\n<\/colgroup>
Name<\/th>Description<\/th><\/tr><\/thead>
\n

createTender<\/code><\/p>\n<\/td>

\n

Creates a tender using a number of attributes.

<\/p>\n

This method returns an immediate response of type LibraryResult<\/code>. Check if this result is \"OK\", before continuing the operation. If the LibraryResult<\/code> value is not \"OK\", the system will not return the related callback with the asynchronous result. See here<\/a> for more on extracting data from an event or callback.<\/p>\n<\/div><\/div>\n<\/td><\/tr><\/tbody><\/table>\n

Tender Parameter<\/h2>\n\n\n\n\n\n
Name<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
tender<\/code><\/td>\nTender<\/td>\nHolds tender attributes.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

For gift card operations, you create a tender prior to calling cardOperation<\/code>. This createTender<\/code> must not include a\u00a0 KeyedEntry<\/strong><\/span> tender option.\u00a0 If the original tender contains a KeyedEntry<\/strong><\/span> tender option, it is not possible to perform a cardOperation<\/code>.<\/p>\n<\/div><\/div>\n

Attributes<\/h2>\n
Name<\/th>Type<\/th>Required<\/th>Definition<\/th><\/tr><\/thead>
\n

merchantAccount<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The merchantAccount<\/code> account to receive the money.<\/p>\n<\/td><\/tr>

\n

merchantReference <\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The transaction reference provided by the Merchant (reported in the plataforma de pagamentos da Adyen).<\/p>\n<\/td><\/tr>

\n

currency<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The transaction currency.<\/p>\n<\/td><\/tr>

\n

amount<\/code><\/p>\n<\/td>

\n

long<\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The transaction amount in minor units (100 is 1.00 with EUR).<\/p>\n<\/td><\/tr>

\n

tenderOptions<\/code><\/p>\n<\/td>

\n

Tender.TenderOption<\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The transaction options. Can be an empty TenderOption.<\/p>\n<\/td><\/tr>

\n

transactionType<\/code><\/p>\n<\/td>

\n

TransactionTypes<\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The tender type (GOODS_SERVICES<\/strong><\/span> or REFUND GOODS_SERVICES_WITH_CASHBACK<\/strong><\/span>, CASHOUT<\/strong><\/span>).<\/p>\n<\/td><\/tr>

\n

pspReference<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The tender reference provided by the Adyen PSP (reported in the plataforma de pagamentos da Adyen).

<\/p>\n

A pspReference<\/code> and authCode<\/code> will not be visible if the transaction was performed offline.<\/p>\n<\/div><\/div>\n<\/td><\/tr>

\n

orderReference<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The order reference for split payments (reported in the plataforma de pagamentos da Adyen).<\/p>\n<\/td><\/tr>

\n

originalReference<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The original reference for refunds (reported in the plataforma de pagamentos da Adyen).<\/p>\n<\/td><\/tr>

\n

gratuityAmount<\/code><\/p>\n<\/td>

\n

long<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The tender gratuity amount in minor units (100 is 1.00 with EUR).<\/p>\n<\/td><\/tr>

\n

shopperReference<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Shopper identification (used for omnichannel digital customer recognition; minimum length three characters).<\/p>\n<\/td><\/tr>

\n

shopperEmail<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Shopper identification (used for omnichannel digital customer recognition).<\/p>\n<\/td><\/tr>

\n

recurringContract<\/code><\/p>\n<\/td>

\n

RecurringContract<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Recurring contract if registering for RECURRING<\/strong><\/span> or ONE_CLICK<\/strong><\/span> payments.<\/p>\n<\/td><\/tr>

\n

recurringContractDetail <\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Recurring contract detail key (points at payment details of this Tender).<\/p>\n<\/td><\/tr>

\n

dccData<\/code><\/p>\n<\/td>

\n

DccData\u00a0<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Container for the DCC data.<\/p>\n<\/td><\/tr>

\n

receipts<\/code><\/p>\n<\/td>

\n

List<\/receipts.receiptset><\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Holds a list of receipt information.<\/p>\n<\/td><\/tr>

\n

authCode<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

authorization code for the transaction.

<\/p>\n

A pspReference<\/code> and authCode<\/code> will not be visible if the transaction was performed offline.<\/p>\n<\/div><\/div>\n<\/td><\/tr>

\n

refusalReason<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

Reason for refused transaction, if applicable.<\/p>\n<\/td><\/tr>

\n

tenderPed<\/code><\/p>\n<\/td>

\n

AdyenPed<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The PED to run this transaction on, do not serialize it<\/p>\n<\/td><\/tr>

\n

terminalId<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The PED to process the transaction on.<\/p>\n<\/td><\/tr>

\n

adjustCurrency<\/code><\/p>\n<\/td>

\n

String<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The transaction adjusted currency.<\/p>\n<\/td><\/tr>

\n

adjustAmount<\/code><\/p>\n<\/td>

\n

long<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The transaction adjusted amount in minor units (100 is 1.00 with EUR).<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

Passing tender options<\/h2>\n

Pass tender options, such as creating a recurring contract, with the TenderOption<\/code> list. For more information, see \n pass tender options<\/strong>\n<\/a>.<\/p>\n

Determine the current and final tender state<\/h2>\n

Adyen provides a method to determine the current, or final, tender state. For more information, see\u00a0\n Determine the current and final tender state - JNI<\/strong>\n<\/a>.<\/p>\n

Callbacks<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
createTenderCallback<\/code><\/td>\nImmediate callback to creation of the tender.<\/td>\n<\/tr>\n
\n <span translate=\"no\">**progressCallback**<\/span><\/code>\n<\/a><\/td>\nReports the progress on a running tender<\/td>\n<\/tr>\n
\n <span translate=\"no\">**additionalDataCallback**<\/span><\/code>\n<\/a><\/td>\nInvoked after the shopper inserts or swipes a card. Retrieves additional data about the cardholder.<\/td>\n<\/tr>\n
\n <span translate=\"no\">**tenderDccCallback**<\/span><\/code>\n<\/a><\/td>\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.<\/td>\n<\/tr>\n
\n <span translate=\"no\">**tenderPrintReceiptCallback**<\/span><\/code>\n<\/a><\/td>\nReturns the receipt for printing, and requests that the POS confirms it has received the receipt.<\/td>\n<\/tr>\n
\n <span translate=\"no\">**tenderCheckSignatureCallback**<\/span><\/code>\n<\/a><\/td>\nAllows the store assistant to accept or decline a shopper's signature on the PED.<\/td>\n<\/tr>\n
\n <span translate=\"no\">**finalCallback**<\/span><\/code>\n<\/a><\/td>\nWhen the system finishes processing the tender, it triggers the final state callback.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/process-a-basic-transaction-jni\/create-the-tender-jni","articleFields":{"id":"24217576","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"01-05-2019 11:38"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/process-a-basic-transaction-jni\/create-the-tender-jni","title":"Create the tender","content":"Class\nNameDescription\nMerchantPed\n\nExtends\u00a0 AdyenPed.\u00a0 Class used to implement all PIN entry device (PED) functionality.\n\nMethod\nNameDescription\ncreateTender\n\nCreates a tender using a number of attributes.\nThis method returns an immediate response of type LibraryResult. Check if this result is \"OK\", before continuing the operation. If the LibraryResult value is not \"OK\", the system will not return the related callback with the asynchronous result. See here for more on extracting data from an event or callback.\n\n\nTender Parameter\n\n\n\nName\nType\nDescription\n\n\n\n\ntender\nTender\nHolds tender attributes.\n\n\n\n\nFor gift card operations, you create a tender prior to calling cardOperation. This createTender must not include a\u00a0 KeyedEntry tender option.\u00a0 If the original tender contains a KeyedEntry tender option, it is not possible to perform a cardOperation.\n\nAttributes\nNameTypeRequiredDefinition\nmerchantAccount\n\nString\n\n\n\nThe merchantAccount account to receive the money.\n\nmerchantReference \n\nString\n\n\n\nThe transaction reference provided by the Merchant (reported in the plataforma de pagamentos da Adyen).\n\ncurrency\n\nString\n\n\n\nThe transaction currency.\n\namount\n\nlong\n\n\n\nThe transaction amount in minor units (100 is 1.00 with EUR).\n\ntenderOptions\n\nTender.TenderOption\n\n\n\nThe transaction options. Can be an empty TenderOption.\n\ntransactionType\n\nTransactionTypes\n\n\n\nThe tender type (GOODS_SERVICES or REFUND GOODS_SERVICES_WITH_CASHBACK, CASHOUT).\n\npspReference\n\nString\n\n\n\nThe tender reference provided by the Adyen PSP (reported in the plataforma de pagamentos da Adyen).\nA pspReference and authCode will not be visible if the transaction was performed offline.\n\n\norderReference\n\nString\n\n\n\nThe order reference for split payments (reported in the plataforma de pagamentos da Adyen).\n\noriginalReference\n\nString\n\n\n\nThe original reference for refunds (reported in the plataforma de pagamentos da Adyen).\n\ngratuityAmount\n\nlong\n\n\n\nThe tender gratuity amount in minor units (100 is 1.00 with EUR).\n\nshopperReference\n\nString\n\n\n\nShopper identification (used for omnichannel digital customer recognition; minimum length three characters).\n\nshopperEmail\n\nString\n\n\n\nShopper identification (used for omnichannel digital customer recognition).\n\nrecurringContract\n\nRecurringContract\n\n\n\nRecurring contract if registering for RECURRING or ONE_CLICK payments.\n\nrecurringContractDetail \n\nString\n\n\n\nRecurring contract detail key (points at payment details of this Tender).\n\ndccData\n\nDccData\u00a0\n\n\n\nContainer for the DCC data.\n\nreceipts\n\nList<\/receipts.receiptset>\n\n\n\nHolds a list of receipt information.\n\nauthCode\n\nString\n\n\n\nauthorization code for the transaction.\nA pspReference and authCode will not be visible if the transaction was performed offline.\n\n\nrefusalReason\n\nString\n\n\n\nReason for refused transaction, if applicable.\n\ntenderPed\n\nAdyenPed\n\n\n\nThe PED to run this transaction on, do not serialize it\n\nterminalId\n\nString\n\n\n\nThe PED to process the transaction on.\n\nadjustCurrency\n\nString\n\n\n\nThe transaction adjusted currency.\n\nadjustAmount\n\nlong\n\n\n\nThe transaction adjusted amount in minor units (100 is 1.00 with EUR).\n\nPassing tender options\nPass tender options, such as creating a recurring contract, with the TenderOption list. For more information, see \n pass tender options\n.\nDetermine the current and final tender state\nAdyen provides a method to determine the current, or final, tender state. For more information, see\u00a0\n Determine the current and final tender state - JNI\n.\nCallbacks\n\n\n\nName\nDescription\n\n\n\n\ncreateTenderCallback\nImmediate callback to creation of the tender.\n\n\n\n <span translate=\"no\">**progressCallback**<\/span>\n\nReports the progress on a running tender\n\n\n\n <span translate=\"no\">**additionalDataCallback**<\/span>\n\nInvoked after the shopper inserts or swipes a card. Retrieves additional data about the cardholder.\n\n\n\n <span translate=\"no\">**tenderDccCallback**<\/span>\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\n\n\n <span translate=\"no\">**tenderPrintReceiptCallback**<\/span>\n\nReturns the receipt for printing, and requests that the POS confirms it has received the receipt.\n\n\n\n <span translate=\"no\">**tenderCheckSignatureCallback**<\/span>\n\nAllows the store assistant to accept or decline a shopper's signature on the PED.\n\n\n\n <span translate=\"no\">**finalCallback**<\/span>\n\nWhen the system finishes processing the tender, it triggers the final state callback.\n\n\n","type":"page","locale":"pt","boost":13,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"Java Native Interface 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\/java-native-interface-integration","lvl5":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni","lvl6":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/process-a-basic-transaction-jni","lvl7":"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/process-a-basic-transaction-jni\/create-the-tender-jni"},"levels":8,"category":"In-person payments","category_color":"green","tags":["Create","tender"]}}