{"title":"Calls and callbacks","category":"default","creationDate":1776961627,"content":"<div class=\"sc-notice info\"><div>\n<p>Adyen POS Object Creation\u00a0is a void method.<\/p>\n<\/div><\/div>\n<p>Calls and callbacks follow this flow:<\/p>\n<ol>\n<li>Invoke a method to perform a specific action.<\/li>\n<li>Set a timer to wait for an application-internal flag.<\/li>\n<li>In the callback pass the objects and results to internal objects, set the application-internal wait-flag and proceed to the end of the callback handler.<\/li>\n<li>Proceed with the main flow - handle and process the information obtained in the callback.<\/li>\n<\/ol>\n<div class=\"sc-notice note\"><div>\n<p>For methods from the COM extension for Windows that take arguments, carefully verify these arguments to avoid runtime errors.\u00a0There is no option to validate\u00a0the passed arguments.\u00a0The same applies to the callback arguments, the COM extension for Windows can not validate these for you.<\/p>\n<\/div><\/div>\n<h2 id=\"callback-parameter-order\">Callback Parameter Order<\/h2>\n<p>The C library defines the order, \u00a0but does not enforce it. \u00a0As an example the create tender callback:<\/p>\n<pre><code class=\"language-vb\">CreateTenderCB(objTender, intPedResult, intPspResult, intLibResult, strErrorMessage)<\/code><\/pre>\n<p>The\u00a0<code>CreateTender<\/code>\u00a0callback returns the tender object that should be used to execute subsequent tender-actions.\u00a0<code>strErrorMessage<\/code>\u00a0can be used directly in logging or feedback.<\/p>\n<p>Use the provided helper methods to evaluate the other arguments.\u00a0<\/p>\n<p>Parameters are accessible through the interface in any standard coding tool.\u00a0If necessary, you can observe the IDL provided with the library using an OLE viewer.\u00a0<\/p>\n<h2 id=\"actionable-vs-informational-callbacks\">Actionable vs. Informational Callbacks<\/h2>\n<p>Several callbacks occur during the processing of a tender. There are two types of callback: Actionable and Informational.<\/p>\n<ul>\n<li>Actionable callbacks require action to complete the transaction.<\/li>\n<li>Informational callbacks can be logged\u00a0but are not required to complete a transaction.<\/li>\n<\/ul>\n<p>These callbacks are asynchronous responses to a synchronous call:<\/p>\n<ol>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/initialize-the-library-com-extension\">Library initialization callback<\/a><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/register-the-application-with-adyen-com-extension\">Register POS callback<\/a><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/registering-the-ped-com-extension\/register-the-ped-with-the-adyen-payments-platform-com-extension\">Register PED callback<\/a><\/li>\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\/create-the-tender-com-extension\">Create tender callback<\/a><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/cancel-or-refund-a-transaction-com-extension\/refund-a-transaction-from-the-pos-com\">Cancel or Refund callback<\/a><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/extras-com-extension\/display-a-screen-on-a-large-screen-terminal-com\">Show Screen callback<\/a><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/extras-com-extension\/get-transaction-data-from-txstorereport-com\">TxStoreReport callback<\/a><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/exit-the-library-com-extension\">Library exit callback<\/a><\/li>\n<\/ol>\n<p>These callbacks are related to transactions, and will require actions to be performed:<\/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\/handle-the-signature-callback-com-extension\">Signature Callback<\/a><\/li>\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\/handle-the-additional-data-callback-com-extension\">AdditionalData Callback<\/a><\/li>\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\/handle-the-print-receipt-callback-com-extension\">PrintReceipt Callback<\/a><\/li>\n<\/ul>\n<p>These callbacks are related to transactions, and will require no actions to be performed:<\/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\/handle-progress-events-com-extension\">Progress Event Callback<\/a><\/li>\n<li><a href=\"\/pt\/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><\/li>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/extras-com-extension\/display-a-screen-on-a-large-screen-terminal-com\">Show Screen Callback<\/a><\/li>\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\/handle-the-final-state-callback-com-extension\">Final result callback<\/a><\/li>\n<\/ul>\n<p>General information<\/p>\n<ul>\n<li><a href=\"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/extras-com-extension\/handle-the-librarylog-callback-com-extension\">Library Log Callback<\/a><\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/calls-and-callbacks-com-extension","articleFields":{"id":"25143502","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"26-04-2019 13:13"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/calls-and-callbacks-com-extension","title":"Calls and callbacks","content":"\nAdyen POS Object Creation\u00a0is a void method.\n\nCalls and callbacks follow this flow:\n\nInvoke a method to perform a specific action.\nSet a timer to wait for an application-internal flag.\nIn the callback pass the objects and results to internal objects, set the application-internal wait-flag and proceed to the end of the callback handler.\nProceed with the main flow - handle and process the information obtained in the callback.\n\n\nFor methods from the COM extension for Windows that take arguments, carefully verify these arguments to avoid runtime errors.\u00a0There is no option to validate\u00a0the passed arguments.\u00a0The same applies to the callback arguments, the COM extension for Windows can not validate these for you.\n\nCallback Parameter Order\nThe C library defines the order, \u00a0but does not enforce it. \u00a0As an example the create tender callback:\nCreateTenderCB(objTender, intPedResult, intPspResult, intLibResult, strErrorMessage)\nThe\u00a0CreateTender\u00a0callback returns the tender object that should be used to execute subsequent tender-actions.\u00a0strErrorMessage\u00a0can be used directly in logging or feedback.\nUse the provided helper methods to evaluate the other arguments.\u00a0\nParameters are accessible through the interface in any standard coding tool.\u00a0If necessary, you can observe the IDL provided with the library using an OLE viewer.\u00a0\nActionable vs. Informational Callbacks\nSeveral callbacks occur during the processing of a tender. There are two types of callback: Actionable and Informational.\n\nActionable callbacks require action to complete the transaction.\nInformational callbacks can be logged\u00a0but are not required to complete a transaction.\n\nThese callbacks are asynchronous responses to a synchronous call:\n\nLibrary initialization callback\nRegister POS callback\nRegister PED callback\nCreate tender callback\nCancel or Refund callback\nShow Screen callback\nTxStoreReport callback\nLibrary exit callback\n\nThese callbacks are related to transactions, and will require actions to be performed:\n\nSignature Callback\nAdditionalData Callback\nPrintReceipt Callback\n\nThese callbacks are related to transactions, and will require no actions to be performed:\n\nProgress Event Callback\nDCC Callback\nShow Screen Callback\nFinal result callback\n\nGeneral information\n\nLibrary Log Callback\n","type":"page","locale":"pt","boost":15,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"COM extension for Windows integration","lvl5":"Calls and callbacks"},"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":"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/calls-and-callbacks-com-extension"},"levels":6,"category":"In-person payments","category_color":"green","tags":["Calls","callbacks"]}}
