{"title":"AccountUpdater request file","category":"default","creationDate":1779620072,"content":"<p>The structure of a batch request file from the Account Updater is as follows.<\/p>\n<h2 id=\"accountupdater-lines\">AccountUpdater\u00a0lines<\/h2>\n<p>The line record\u00a0[L] holds the metadata information that applies to its corresponding sub-line [SL] records.<\/p>\n<table><thead><tr class=\"header\"><th><p><strong>Field #<\/strong><\/p><\/th><th><p><strong>Format<\/strong><\/p><\/th><th><p><strong>Required<\/strong><\/p><\/th><th><p><strong>Description<\/strong><\/p><\/th><\/tr><\/thead><tbody><tr><td>\n<p>1<\/p>\n<\/td><td>\n<p>Fixed value: <code>L<\/code><\/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>Record type identifier.<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/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><code>L<\/code> line record number reference within the batch file block it belongs to.The counter starts at 1, and it increments sequentially by one unit.<\/p>\n<\/td><\/tr><tr><td>\n<p>3<\/p>\n<\/td><td>\n<p>Fixed value: <code>MerchantAccount<\/code><\/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>Account type.<br \/>\nDefines the type of account the transactions are related to.<\/p>\n<\/td><\/tr><tr><td>\n<p>4<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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>Specifies the merchant account name.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Fixed value:\u00a0<code>AccountUpdater<\/code> \u00a0<\/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>Processing type.<br \/>\nDefines the type of action that is required for the specified transaction.<\/p>\n<div class=\"notices blue\">\n<p>If the column shows <code>ValidationError<\/code>, then the file shall have the structure of the <a href=\"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file-validationerror\">batch result file (ValidationError)<\/a> instead.<\/p>\n<\/div>\n<\/td><\/tr><tr><td>\n<p>6<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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>A merchant reference, that is, a unique identifier associated to a specific transaction.<\/p>\n<\/td><\/tr><tr><td>\n<p>7<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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><code>EchoData<\/code><br>In this field you can specify any data you may want to be returned with the result file. When this field is populated, its content is returned exactly as is. The\u00a0Adyen payments platform does not use this data.<br>Maximum character length: 80 characters.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h2 id=\"accountupdater-sub-lines\">AccountUpdater sub-lines<\/h2>\n<p>There are two kinds of Account Updater requests: <code>AccountUpdaterRecurring<\/code> request and <code>AccountUpdaterSingle<\/code> request.<\/p>\n<h3>AccountUpdaterRecurring request<\/h3>\n<p>You can make an\u00a0<code>AccountUpdaterRecurring<\/code> request when no payment details for the shopper are available.<br \/>\nThe <code>AccountUpdaterRecurring<\/code> request stores shopper payment details in a <a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\">recurring contract<\/a>.<\/p>\n<h3 id=\"mandatory-sub-lines\">Mandatory sub-lines<\/h3>\n<table><thead><tr class=\"header\"><th><p>Field #<\/p><\/th><th><p>Format<\/p><\/th><th><p>Required<\/p><\/th><th><p>Description<\/p><\/th><\/tr><\/thead><tbody><tr><td>\n<p>1<\/p>\n<\/td><td>\n<p>Fixed value: <code>SL<\/code><\/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>Record type identifier<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/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><p>`SL` sub-line record number reference within its parent line.<br>\nThe counter starts at 1, and it increments sequentially by one unit.<\/p><\/td><\/tr><tr><td>\n<p>3<\/p>\n<\/td><td>\n<p>Fixed value: <code>AccountUpdaterRecurring<\/code><\/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>Transaction type. <br>Defines the required field types for the specific sub-line.<\/p>\n<\/td><\/tr><tr><td>\n<p>4<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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>A shopper's reference, which is the unique identifier for a shopper.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Allowed values:<ul><li markdown=\"1\">If the card details are not stored - The card alias<\/li><li markdown=\"1\">If the card details are stored:<ul><li markdown=\"1\">recurring<code>DetailReference<\/code>\u00a0Or<\/li><li markdown=\"1\"><code>LATEST<\/code><\/li><\/ul><\/li><\/ul><\/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>Allowed values:<\/p>\n<ul>\n<li>If the card details are not stored - The card alias<\/li>\n<li>\n<p>If the card details are stored:<\/p>\n<ul>\n<li>recurring<code>DetailReference<\/code>\u00a0Or<\/li>\n<li><code>LATEST<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td><\/tr><\/tbody><\/table>\n<h3 id=\"example\">Example<\/h3>\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,AccountUpdater,MerchantReference1,EchoData1\nSL,1,AccountUpdaterRecurring,s.hopper@email.com,LATEST\nBT,1\nFT,1<\/code><\/pre>\n<h3>AccountUpdaterSingle request<\/h3>\n<p>You can make an\u00a0<code>AccountUpdaterSingle<\/code> request when the shopper's card details are at least partially available in your records.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>You can send live\/actual card numbers with your batch file only if you\u00a0<a href=\"\/development-resources\/batch-processing\/advanced-sftp-batch-files#pgp-encryption\">encrypt the file with PGP<\/a>\u00a0before submitting it.<\/p>\n<\/div><\/div>\n<h3 id=\"mandatory-sub-lines\">Mandatory sub-lines<\/h3>\n<div class=\"sc-notice info\"><div>\n<p>This sub-line holds information about single, ad-hoc account update requests.<\/p>\n<\/div><\/div>\n<table><thead><tr class=\"header\"><th><p><strong>Field #<\/strong><\/p><\/th><th><p><strong>Format<\/strong><\/p><\/th><th><p><strong>Required<\/strong><\/p><\/th><th><p><strong>Description<\/strong><\/p><\/th><\/tr><\/thead><tbody><tr><td>\n<p>1<\/p>\n<\/td><td>\n<p>Fixed value: <code>SL<\/code><\/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>Record type identifier<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/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>`SL` sub-line record number reference within its parent line.<br>\nThe counter starts at 1, and it increments sequentially by one unit.<\/td><\/tr><tr><td>\n<p>3<\/p>\n<\/td><td>\n<p>Fixed value: <code>AccountUpdaterSingle<\/code><\/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>Transaction type. <br>Defines the required field types for the specific sub-line.<\/p>\n<\/td><\/tr><tr><td>\n<p>4<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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>Card number or card alias.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Numeric<\/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>Expiry month.<ul><li markdown=\"1\">Format: <code>MM<\/code>, zero-padded (eg: <em>03<\/em>)<\/li><\/ul><\/p>\n<\/td><\/tr><tr><td>\n<p>6<\/p>\n<\/td><td>\n<p>Numeric<\/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>Expiry year.<ul><li markdown=\"1\">Format: <code>YYYY<\/code> (eg: <em>2016<\/em>)<\/li><\/ul><\/p>\n<\/td><\/tr><tr><td>\n<p>7<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td><p><a href=\"https:\/\/www.cvvnumber.com\/cvv.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">CVC code<\/a>.<br>\nLeave this field blank.<\/p><\/td><\/tr><tr><td>\n<p>8<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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>Cardholder name.<\/p>\n<\/td><\/tr><tr><td>\n<p>9<\/p>\n<\/td><td>\n<p>Numeric<\/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>Start month.<ul><li markdown=\"1\">Format: <code>MM<\/code>, zero-padded (eg: <em>03<\/em>)<\/li><\/ul><div class=\"sc-notice info\"><div><p>Maestro UK only.<\/p><\/div><\/div><\/p>\n<\/td><\/tr><tr><td>\n<p>10<\/p>\n<\/td><td>\n<p>Numeric<\/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>Start year.<ul><li markdown=\"1\">Format: <code>YYYY<\/code> (eg: <em>2016<\/em>)<\/li><\/ul><div class=\"sc-notice info\"><div><p>Maestro UK only.<\/p><\/div><\/div><\/p>\n<\/td><\/tr><tr><td>\n<p>11<\/p>\n<\/td><td>\n<p>Numeric<\/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>One-digit card issue number.<div class=\"sc-notice info\"><div>Maestro UK only.<\/div><\/div><\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h3 id=\"example\">Example<\/h3>\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,AccountUpdater,MerchantReference1,EchoData1\nSL,1,AccountUpdaterSingle,4111111111111111,06,2016,,CardHolderName,,,\nBT,1\nFT,1<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/accountupdater-request-file","articleFields":{"id":"24216663","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"21-10-2019 13:05"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/accountupdater-request-file","title":"AccountUpdater request file","content":"The structure of a batch request file from the Account Updater is as follows.\nAccountUpdater\u00a0lines\nThe line record\u00a0[L] holds the metadata information that applies to its corresponding sub-line [SL] records.\nField #FormatRequiredDescription\n1\n\nFixed value: L\n\n\n\nRecord type identifier.\n\n2\n\nNumeric\n\n\n\nL line record number reference within the batch file block it belongs to.The counter starts at 1, and it increments sequentially by one unit.\n\n3\n\nFixed value: MerchantAccount\n\n\n\nAccount type.\nDefines the type of account the transactions are related to.\n\n4\n\nAlphanumeric\n\n\n\nSpecifies the merchant account name.\n\n5\n\nFixed value:\u00a0AccountUpdater \u00a0\n\n\n\nProcessing type.\nDefines the type of action that is required for the specified transaction.\n\nIf the column shows ValidationError, then the file shall have the structure of the batch result file (ValidationError) instead.\n\n\n6\n\nAlphanumeric\n\n\n\nA merchant reference, that is, a unique identifier associated to a specific transaction.\n\n7\n\nAlphanumeric\n\n\n\nEchoDataIn this field you can specify any data you may want to be returned with the result file. When this field is populated, its content is returned exactly as is. The\u00a0Adyen payments platform does not use this data.Maximum character length: 80 characters.\n\nAccountUpdater sub-lines\nThere are two kinds of Account Updater requests: AccountUpdaterRecurring request and AccountUpdaterSingle request.\nAccountUpdaterRecurring request\nYou can make an\u00a0AccountUpdaterRecurring request when no payment details for the shopper are available.\nThe AccountUpdaterRecurring request stores shopper payment details in a recurring contract.\nMandatory sub-lines\nField #FormatRequiredDescription\n1\n\nFixed value: SL\n\n\n\nRecord type identifier\n\n2\n\nNumeric\n\n\n`SL` sub-line record number reference within its parent line.\nThe counter starts at 1, and it increments sequentially by one unit.\n3\n\nFixed value: AccountUpdaterRecurring\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nAlphanumeric\n\n\n\nA shopper's reference, which is the unique identifier for a shopper.\n\n5\n\nAllowed values:If the card details are not stored - The card aliasIf the card details are stored:recurringDetailReference\u00a0OrLATEST\n\n\n\nAllowed values:\n\nIf the card details are not stored - The card alias\n\nIf the card details are stored:\n\nrecurringDetailReference\u00a0Or\nLATEST\n\n\n\n\nExample\nFH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,AccountUpdater,MerchantReference1,EchoData1\nSL,1,AccountUpdaterRecurring,s.hopper@email.com,LATEST\nBT,1\nFT,1\nAccountUpdaterSingle request\nYou can make an\u00a0AccountUpdaterSingle request when the shopper's card details are at least partially available in your records.\n\nYou can send live\/actual card numbers with your batch file only if you\u00a0encrypt the file with PGP\u00a0before submitting it.\n\nMandatory sub-lines\n\nThis sub-line holds information about single, ad-hoc account update requests.\n\nField #FormatRequiredDescription\n1\n\nFixed value: SL\n\n\n\nRecord type identifier\n\n2\n\nNumeric\n\n\n`SL` sub-line record number reference within its parent line.\nThe counter starts at 1, and it increments sequentially by one unit.\n3\n\nFixed value: AccountUpdaterSingle\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nAlphanumeric\n\n\n\nCard number or card alias.\n\n5\n\nNumeric\n\n\n\nExpiry month.Format: MM, zero-padded (eg: 03)\n\n6\n\nNumeric\n\n\n\nExpiry year.Format: YYYY (eg: 2016)\n\n7\n\nNumeric\n\n\nCVC code.\nLeave this field blank.\n8\n\nAlphanumeric\n\n\n\nCardholder name.\n\n9\n\nNumeric\n\n\n\nStart month.Format: MM, zero-padded (eg: 03)Maestro UK only.\n\n10\n\nNumeric\n\n\n\nStart year.Format: YYYY (eg: 2016)Maestro UK only.\n\n11\n\nNumeric\n\n\n\nOne-digit card issue number.Maestro UK only.\n\nExample\nFH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,AccountUpdater,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,AccountUpdater,MerchantReference1,EchoData1\nSL,1,AccountUpdaterSingle,4111111111111111,06,2016,,CardHolderName,,,\nBT,1\nFT,1","type":"page","locale":"en","boost":15,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Batch processing","lvl3":"Submit transaction batch files through SFTP","lvl4":"Batch request file","lvl5":"AccountUpdater request file"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/development-resources","lvl2":"https:\/\/docs.adyen.com\/development-resources\/batch-processing","lvl3":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files","lvl4":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file","lvl5":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/accountupdater-request-file"},"levels":6,"category":"Development Resources","category_color":"green","tags":["AccountUpdater","request"]}}
