{"title":"Handle the Additional Data callback","category":"default","creationDate":1776961627,"content":"<h2 id=\"callback\">\u00a0Callback<\/h2>\n<table><thead><tr class=\"header\"><th>Name<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td><code>tenderAdditionalDataCallback <\/code><\/td><td><p>Invoked after the shopper inserts or swipes a card. Uses the card number as a key to retrieve additional data about the cardholder, like loyalty and customer recognition data.\u00a0<\/p><p>AdditionalData defined by a tender will contain only the data coming from the terminal. To provide additional data to the terminal, use the operations <code>createTender<\/code> and <code>confirmAdditionalData<\/code> passing an extra parameter.<\/p><div class=\"sc-notice note\"><div> Create the tender with the tender option\u00a0 <code>getAdditionalData<\/code> to trigger the <code>tenderAdditionalDataCallback<\/code>. <\/div><\/div><\/td><\/tr><\/tbody><\/table>\n<h2 id=\"parameter\">Parameter<\/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>tender<\/code><\/td>\n<td>Object that holds the tender attributes.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"callback-response-attributes\">Callback Response Attributes<\/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>additionalData<\/code><\/td>\n<td>Additional data returned by Adyen.\u00a0 The\u00a0 <code>additionalData<\/code> \u00a0object is a generic container that can hold extra response fields.<\/td>\n<\/tr>\n<tr>\n<td><code>tenderReference<\/code><\/td>\n<td>Transaction reference provided by the PED (reported in Adyen back end).<\/td>\n<\/tr>\n<tr>\n<td><code>tenderState<\/code><\/td>\n<td>Transaction state.<\/td>\n<\/tr>\n<tr>\n<td><code>adyenResult<\/code><\/td>\n<td>Transaction result details.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"confirming-and-providing-additional-data-for-credit-cards\">Confirming and providing Additional Data for Credit Cards<\/h2>\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>confirmAddionalData<\/code><\/td>\n<td>Provides additional data to the terminal.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"parameters\">Parameters<\/h2>\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>tender<\/code><\/td>\n<td>Tender<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Use this as a key to confirm additional data.<\/td>\n<\/tr>\n<tr>\n<td><code>modification<\/code><\/td>\n<td>boolean<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Input parameter of <code>confirmAddionalData<\/code>. When sending this call it is possible to modify some of the fields of the tender, i.e amount. The parameter modification lets the caller specify if the library should expect updates on the tender object or not.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"confirming-and-providing-additional-data-for-gift-cards\">Confirming and providing Additional Data for Gift Cards<\/h2>\n<h2 id=\"method-1\">Method<\/h2>\n<table style=\"width:100%;\"><colgroup><col style=\"width: 24%\"><col style=\"width: 75%\"><\/colgroup><thead><tr class=\"header\"><th>Name<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td><p><code>confirmAdditionalDataCardOperation<\/code><\/p><\/td><td><p>Provides additional data to the terminal.<\/p><\/td><\/tr><\/tbody><\/table>\n<h2 id=\"parameters-1\">Parameters<\/h2>\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>giftCard<\/code><\/td>\n<td>GiftCard<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Use this as a key to confirm additional data.<\/td>\n<\/tr>\n<tr>\n<td><code>modification<\/code><\/td>\n<td>boolean<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Input parameter of the <code>confirmAdditionalDataCardOperation<\/code>. When sending this call it is possible to modify some of the fields of the tender, i.e amount. The parameter modification lets the caller specify if the library should expect updates on the tender object or not.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"determine-the-current-and-final-tender-state\">Determine the current and final tender state<\/h2>\n<p>Adyen provides a method to determine the current, or final, tender state. For more information, see\u00a0<a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/process-a-basic-transaction-jni\/determine-the-current-and-final-tender-state-jni\">Determine the current and final tender state - JNI<\/a>.<\/p>","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\/handle-the-additional-data-callback-jni","articleFields":{"id":"24217586","type":"page","_expandable":{"operations":""},"status":"current"},"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\/handle-the-additional-data-callback-jni","title":"Handle the Additional Data callback","content":"\u00a0Callback\nNameDescriptiontenderAdditionalDataCallback Invoked after the shopper inserts or swipes a card. Uses the card number as a key to retrieve additional data about the cardholder, like loyalty and customer recognition data.\u00a0AdditionalData defined by a tender will contain only the data coming from the terminal. To provide additional data to the terminal, use the operations createTender and confirmAdditionalData passing an extra parameter. Create the tender with the tender option\u00a0 getAdditionalData to trigger the tenderAdditionalDataCallback. \nParameter\n\n\n\nName\nDescription\n\n\n\n\ntender\nObject that holds the tender attributes.\n\n\n\nCallback Response Attributes\n\n\n\nName\nDescription\n\n\n\n\nadditionalData\nAdditional data returned by Adyen.\u00a0 The\u00a0 additionalData \u00a0object is a generic container that can hold extra response fields.\n\n\ntenderReference\nTransaction reference provided by the PED (reported in Adyen back end).\n\n\ntenderState\nTransaction state.\n\n\nadyenResult\nTransaction result details.\n\n\n\nConfirming and providing Additional Data for Credit Cards\nMethod\n\n\n\nName\nDescription\n\n\n\n\nconfirmAddionalData\nProvides additional data to the terminal.\n\n\n\nParameters\n\n\n\nName\nType\nRequired\nDescription\n\n\n\n\ntender\nTender\n\nUse this as a key to confirm additional data.\n\n\nmodification\nboolean\n\nInput parameter of confirmAddionalData. When sending this call it is possible to modify some of the fields of the tender, i.e amount. The parameter modification lets the caller specify if the library should expect updates on the tender object or not.\n\n\n\nConfirming and providing Additional Data for Gift Cards\nMethod\nNameDescriptionconfirmAdditionalDataCardOperationProvides additional data to the terminal.\nParameters\n\n\n\nName\nType\nRequired\nDescription\n\n\n\n\ngiftCard\nGiftCard\n\nUse this as a key to confirm additional data.\n\n\nmodification\nboolean\n\nInput parameter of the confirmAdditionalDataCardOperation. When sending this call it is possible to modify some of the fields of the tender, i.e amount. The parameter modification lets the caller specify if the library should expect updates on the tender object or not.\n\n\n\nDetermine the current and final tender state\nAdyen provides a method to determine the current, or final, tender state. For more information, see\u00a0Determine the current and final tender state - JNI.","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":"Handle the Additional Data callback"},"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\/handle-the-additional-data-callback-jni"},"levels":8,"category":"In-person payments","category_color":"green","tags":["Handle","Additional","callback"]}}