{"title":"Batch result file with validation errors","category":"default","creationDate":1779796135,"content":"<p>This topic describes the structure of a batch result file when a parsing or validation error occurs. For the batch result structure in case of success,\u00a0see\u00a0the specific batch result file type page. Note that this does not mean that the entire batch result file is an error. There can be successful lines and validation errors within the same batch result file. <\/p>\n<h2 id=\"batch-line\">Batch line<\/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>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>Record type identifier.<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td><p>`L` line record number reference within the batch file block it belongs to.<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>MerchantAccount<\/code><\/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>Specifies the merchant account name.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Fixed value: <code>ParseOrValidationError<\/code><\/p>\n<\/td><td>\n<p>Indicates that an error occurs while processing the batch request.<\/p>\n<\/td><\/tr><tr><td>\n<p>6<\/p>\n<\/td><td>\n<p>Alphanumeric<\/p>\n<\/td><td>\n<p>A merchant reference, that is, a unique identifier associated to a specific transaction.<div class=\"sc-notice info\"><div>This field is populated and is returned if an optional merchant reference value is included in the\u00a0<a href=\"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/modification-request-file\">corresponding request file<\/a>.<\/div><\/div><\/p>\n<\/td><\/tr><tr><td>\n<p>7<\/p>\n<\/td><td>\n<p>Fixed value: <code>ValidationError<\/code><\/p>\n<\/td><td>\n<p>Indicates that an error occurs while processing the batch request.<\/p>\n<\/td><\/tr><tr><td>\n<p>8<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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=\"batch-sub-line\">Batch sub-line<\/h2>\n<table style=\"width:100%;\"><colgroup><col style=\"width: 4%\"><col style=\"width: 22%\"><col style=\"width: 73%\"><\/colgroup><thead><tr class=\"header\"><th><p><strong>Field #<\/strong><\/p><\/th><th><p><strong>Format<\/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>Record type identifier.<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/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>ValidationErrorResult<\/code><\/p>\n<\/td><td><p>Indicates that an error occurs while processing the batch request.<br>\n<\/p><\/td><\/tr><tr><td>\n<p>4<\/p>\n<\/td><td>\n<p>Empty<\/p>\n<\/td><td>\n<p>This value must be empty.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Alphanumeric<\/p>\n<\/td><td>\n<p>The description of the error message. Possible values:<ul><li markdown=\"1\">Invalid amount specified<\/li><li markdown=\"1\">Original pspReference required for this operation<\/li><li markdown=\"1\">Payment type is invalid<\/li><\/ul><p>For the full list, refer to <a href=\"\/development-resources\/response-handling\">Response handling<\/a> (Error codes returned).<\/p><\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h2 id=\"examples\">Examples<\/h2>\n<p>The following example shows the response when invalid amount was specified in a modification request:<\/p>\n<pre><code class=\"language-text\">L,1,MerchantAccount,TestMerchant,ParseOrValidationError,N\/A,ValidationError,\nSL,1,ValidationErrorResult,,Invalid amount specified<\/code><\/pre>\n<p>The example below shows the response when a PSP reference was missing in a modification request:<\/p>\n<pre><code class=\"language-text\">L,1,MerchantAccount,TestMerchant,ParseOrValidationError,441231,ValidationError,\nSL,1,ValidationErrorResult,,Original pspReference required for this operation<\/code><\/pre>\n<p>The following example shows the response when an invalid merchant account was specified in an Account Updater request:<\/p>\n<pre><code class=\"language-text\">L,14,MerchantAccount,N\/A,ParseOrValidationError,441231,ValidationError,\nSL,1,ValidationErrorResult,,Invalid Merchant Account<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file-validationerror","articleFields":{"id":"36182867","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"25-10-2019 16:40"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file-validationerror","title":"Batch result file with validation errors","content":"This topic describes the structure of a batch result file when a parsing or validation error occurs. For the batch result structure in case of success,\u00a0see\u00a0the specific batch result file type page. Note that this does not mean that the entire batch result file is an error. There can be successful lines and validation errors within the same batch result file. \nBatch line\nThe line record\u00a0[L] holds the metadata information that applies to its corresponding sub-line [SL] records.\nField #FormatDescription\n1\n\nFixed value: L\n\nRecord type identifier.\n\n2\n\nNumeric\n`L` line record number reference within the batch file block it belongs to.\nThe counter starts at 1, and it increments sequentially by one unit.\n3\n\nFixed value: MerchantAccount\n\nAccount type.\nDefines the type of account the transactions are related to.\n\n4\n\nAlphanumeric\n\nSpecifies the merchant account name.\n\n5\n\nFixed value: ParseOrValidationError\n\nIndicates that an error occurs while processing the batch request.\n\n6\n\nAlphanumeric\n\nA merchant reference, that is, a unique identifier associated to a specific transaction.This field is populated and is returned if an optional merchant reference value is included in the\u00a0corresponding request file.\n\n7\n\nFixed value: ValidationError\n\nIndicates that an error occurs while processing the batch request.\n\n8\n\nAlphanumeric\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\nBatch sub-line\nField #FormatDescription\n1\n\nFixed value: SL\n\nRecord type identifier.\n\n2\n\nNumeric\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: ValidationErrorResult\nIndicates that an error occurs while processing the batch request.\n\n4\n\nEmpty\n\nThis value must be empty.\n\n5\n\nAlphanumeric\n\nThe description of the error message. Possible values:Invalid amount specifiedOriginal pspReference required for this operationPayment type is invalidFor the full list, refer to Response handling (Error codes returned).\n\nExamples\nThe following example shows the response when invalid amount was specified in a modification request:\nL,1,MerchantAccount,TestMerchant,ParseOrValidationError,N\/A,ValidationError,\nSL,1,ValidationErrorResult,,Invalid amount specified\nThe example below shows the response when a PSP reference was missing in a modification request:\nL,1,MerchantAccount,TestMerchant,ParseOrValidationError,441231,ValidationError,\nSL,1,ValidationErrorResult,,Original pspReference required for this operation\nThe following example shows the response when an invalid merchant account was specified in an Account Updater request:\nL,14,MerchantAccount,N\/A,ParseOrValidationError,441231,ValidationError,\nSL,1,ValidationErrorResult,,Invalid Merchant Account","type":"page","locale":"en","boost":15,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Batch processing","lvl3":"Submit transaction batch files through SFTP","lvl4":"Batch result file","lvl5":"Batch result file with validation errors"},"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-result-file","lvl5":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file-validationerror"},"levels":6,"category":"Development Resources","category_color":"green","tags":["Batch","result","validation","errors"]}}