{"title":"Register the PED with the Adyen payments platform","category":"default","creationDate":1776961627,"content":"<p>Do this when you connect the PED for the first time (and it is not yet registered), or when the PED is in a device state where tenders can not be processed. Retrieve the device state by looking at the\u00a0<span translate=\"no\"><strong>Device State<\/strong><\/span>\u00a0of the PED object under control of the cash register.<\/p>\n<p>Invoking a\u00a0<code>RefreshPED<\/code>\u00a0on the PED object causes a\u00a0<code>PEDStateChange<\/code>\u00a0callback. Use this to update and validate the device state prior to starting a tender on the PED.<\/p>\n<div class=\"sc-notice warning\"><div>\n<p>The cash register should not invoke a <code>RegisterPED<\/code> for every tender to be processed.<\/p>\n<\/div><\/div>\n<div class=\"sc-notice note\"><div>\n<p>You can register more than one PED on the library with the RegisterPED method. The cash register performs tenders on the PED of choice. All callbacks relating to tender progress include a PED object to allow the cash register to decide if any action is required.<\/p>\n<\/div><\/div>\n<h2 id=\"pos-object\">POS Object<\/h2>\n<table style=\"width:100%;\"><colgroup><col style=\"width: 5%\"><col style=\"width: 94%\"><\/colgroup><thead><tr class=\"header\"><th>Name<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>\n<p><code>POS<\/code><\/p>\n<\/td><td>\n<p>POS object that represents the cash register application.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h2 id=\"registerped-method\">RegisterPED Method<\/h2>\n<table style=\"width:100%;\"><colgroup><col style=\"width: 10%\"><col style=\"width: 89%\"><\/colgroup><thead><tr class=\"header\"><th>Name<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>\n<p><code>RegisterPED<\/code><\/p>\n<\/td><td>\n<p>When <code>RegisterPED<\/code> is invoked, the COM extension for Windows handles multiple steps for the cash register:<ol><li markdown=\"1\">Registering the PED device on the merchant account in the Adyen payments platform.<\/li><li markdown=\"1\">Providing the initial configuration from the Adyen payments platform to the PED.<\/li><li markdown=\"1\">Exposing the PED to the library.<\/li><li markdown=\"1\">Returning the PED object to the cash register (in the callback) to pass control over the PED to the cash register.<\/li><\/ol><\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h2 id=\"registerped-parameters\">RegisterPED Parameters<\/h2>\n<table style=\"width:100%;\"><colgroup><col style=\"width: 7%\"><col style=\"width: 5%\"><col style=\"width: 7%\"><col style=\"width: 80%\"><\/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>address<\/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>Address of the PED (can be IP, COM port, URL, etc.)<\/p>\n<\/td><\/tr><tr><td>\n<p><code>name<\/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>Logical name assigned to the PED.<\/p>\n<\/td><\/tr><\/tbody><\/table>","url":"https:\/\/docs.adyen.com\/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","articleFields":{"id":"25143508","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/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","title":"Register the PED with the Adyen payments platform","content":"Do this when you connect the PED for the first time (and it is not yet registered), or when the PED is in a device state where tenders can not be processed. Retrieve the device state by looking at the\u00a0Device State\u00a0of the PED object under control of the cash register.\nInvoking a\u00a0RefreshPED\u00a0on the PED object causes a\u00a0PEDStateChange\u00a0callback. Use this to update and validate the device state prior to starting a tender on the PED.\n\nThe cash register should not invoke a RegisterPED for every tender to be processed.\n\n\nYou can register more than one PED on the library with the RegisterPED method. The cash register performs tenders on the PED of choice. All callbacks relating to tender progress include a PED object to allow the cash register to decide if any action is required.\n\nPOS Object\nNameDescription\nPOS\n\nPOS object that represents the cash register application.\n\nRegisterPED Method\nNameDescription\nRegisterPED\n\nWhen RegisterPED is invoked, the COM extension for Windows handles multiple steps for the cash register:Registering the PED device on the merchant account in the Adyen payments platform.Providing the initial configuration from the Adyen payments platform to the PED.Exposing the PED to the library.Returning the PED object to the cash register (in the callback) to pass control over the PED to the cash register.\n\nRegisterPED Parameters\nNameTypeRequiredDescription\naddress\n\nString\n\n\n\nAddress of the PED (can be IP, COM port, URL, etc.)\n\nname\n\nString\n\n\n\nLogical name assigned to the PED.\n","type":"page","locale":"en","boost":13,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"COM extension for Windows integration","lvl5":"Key steps","lvl6":"Registering the PED","lvl7":"Register the PED with the Adyen payments platform"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation","lvl3":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations","lvl4":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration","lvl5":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension","lvl6":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/registering-the-ped-com-extension","lvl7":"\/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"},"levels":8,"category":"In-person payments","category_color":"green","tags":["Register","Adyen","payments","platform"]}}
