{"title":"Modification result file","category":"default","creationDate":1779620072,"content":"

This topic describes the structure of a result file in case of a successful modification. When parsing or validation errors occur, the result file has the structure described in batch result files with validation errors<\/a>.<\/p>\n

Modification line<\/h2>\n

The line record\u00a0[L] holds the metadata information that applies to its corresponding sub-line [SL] records.<\/p>\n

Field #<\/strong><\/p><\/th>

Format<\/strong><\/p><\/th>

Description<\/strong><\/p><\/th><\/tr><\/thead>

\n

1<\/p>\n<\/td>

\n

Fixed value: L<\/code><\/p>\n<\/td>

\n

Record type identifier.<\/p>\n<\/td><\/tr>

\n

2<\/p>\n<\/td>

\n

Numeric<\/p>\n<\/td>

`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.<\/p><\/td><\/tr>

\n

3<\/p>\n<\/td>

\n

Fixed value: MerchantAccount<\/code><\/p>\n<\/td>

\n

Account type.
\nDefines the type of account the transactions are related to.<\/p>\n<\/td><\/tr>

\n

4<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

Specifies the merchant account name.<\/p>\n<\/td><\/tr>

\n

5<\/p>\n<\/td>

\n

Allowed values:

  • Cancel<\/code><\/li>
  • Refund<\/code><\/li>
  • Capture<\/code><\/li>
  • CaptureOrRefund<\/code><\/li>
  • AuthoriseReferral<\/code><\/li><\/ul><\/p>\n<\/td>
\n

Processing type.
\nDefines the type of action that is required for the specified transaction.<\/p>\n

\n

If the column shows ValidationError<\/code>, then the file shall have the structure of the batch result file (ValidationError)<\/a> instead.<\/p>\n<\/div>\n<\/td><\/tr>

\n

6<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

A 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<\/a>.<\/div><\/div><\/p>\n<\/td><\/tr>
\n

7<\/p>\n<\/td>

\n

Allowed values:<\/p>\n

    \n
  • Success<\/code><\/li>\n
  • Error<\/code><\/li>\n
  • Pending<\/code><\/li>\n<\/ul>\n<\/td>

Transaction status.\n\n

\nA Pending status means that the modification request needs to be postponed for processing.\n<\/div><\/div>
\n<\/p><\/td><\/tr>
\n

8<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

EchoData<\/code>
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.
Maximum character length: 80 characters.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

Modification sub-line<\/h2>\n

Field #<\/strong><\/p><\/th>

Format<\/strong><\/p><\/th>

Description<\/strong><\/p><\/th><\/tr><\/thead>

\n

1<\/p>\n<\/td>

\n

Fixed value: SL<\/code><\/p>\n<\/td>

\n

Record type identifier.<\/p>\n<\/td><\/tr>

\n

2<\/p>\n<\/td>

\n

Numeric<\/p>\n<\/td>

`SL` sub-line record number reference within its parent line.
\nThe counter starts at 1, and it increments sequentially by one unit.<\/p><\/td><\/tr>

\n

3<\/p>\n<\/td>

\n

Fixed value:\u00a0ModificationResult<\/code><\/p>\n<\/td>

Result type identifier.
\n<\/p><\/td><\/tr>

\n

4<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

The unique PSP reference identifier for this modification.
\n<\/p><\/td><\/tr>

\n

5<\/p>\n<\/td>

\n

Alphanumeric<\/p>\n<\/td>

\n

The unique PSP reference identifier for\u00a0the original payment authorisation<\/em>.<\/p>\n<\/td><\/tr>

\n

6<\/p>\n<\/td>

Alphabetic
\n<\/p><\/td>

\n

When the payment is not authorised, it is refused, or if an error occurs, this field holds Adyen's mapped reason for the refusal or a description of the error.<\/p>\n

Possible error messages:<\/p>\n

    \n
  • Transaction not found<\/li>\n
  • Transaction is expired<\/li>\n
  • Insufficient balance on payment<\/li>\n
  • Only possible to refund the full amount<\/li>\n
  • Only possible to capture the full amount<\/li>\n
  • Modification in different currency than authorisation<\/li>\n
  • Internal error<\/li>\n
  • Operation not available<\/li>\n
  • Operation not allowed<\/li>\n
  • Operation failed<\/li>\n
  • Recurring not supported for this payment method<\/li>\n
  • Recurring transaction failed<\/li>\n
  • Recurring contract is not active<\/li>\n
  • Recurring contract not found<\/li>\n
  • Recurring initial payment not found<\/li>\n
  • Recurring initial payment not available<\/li>\n
  • Recurring contract already exists<\/li>\n
  • Fund Transfer not supported for this payment method<\/li>\n
  • Fund Transfer failed<\/li>\n
  • Fund Transfer: initial payment not found<\/li>\n
  • Fund Transfer: Original Transaction is never authorised<\/li>\n
  • The payment details have expired<\/li>\n
  • Fund Transfer: unable to transfer to this bankaccount<\/li>\n
  • InvoiceLines are incorrect<\/li>\n
  • Incomplete or invalid payment details<\/li>\n
  • No suitable capture found for partial refund<\/li>\n
  • Invalid referral authorisation code<\/li>\n<\/ul>\n<\/td><\/tr><\/tbody><\/table>\n

    Example<\/h2>\n
    FH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,Modification,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,Capture,9874560210158741,Success,\nSL,1,ModificationResult,9874560210158741,9248732154865245,\nL,2,MerchantAccount,TestMerchant,Capture,9541236985175236,Error,EchoData1\nSL,1,ModificationResult,9541236985175236,9248732154851572,Transaction not found\nL,3,MerchantAccount,TestMerchant,Refund,95412367785175236,Error,EchoData2\nSL,1,ModificationResult,95412367785175236,9358752154851572,Insufficient balance on payment\nBT,3\nFT,1<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file","articleFields":{"id":"24216670","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"25-10-2019 16:38"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file","title":"Modification result file","content":"This topic describes the structure of a result file in case of a successful modification. When parsing or validation errors occur, the result file has the structure described in batch result files with validation errors.\nModification 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\nAllowed values:CancelRefundCaptureCaptureOrRefundAuthoriseReferral\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\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\nAllowed values:\n\nSuccess\nError\nPending\n\nTransaction status.\n\n\nA Pending status means that the modification request needs to be postponed for processing.\n\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\nModification 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:\u00a0ModificationResult\nResult type identifier.\n\n4\n\nAlphanumeric\nThe unique PSP reference identifier for this modification.\n\n5\n\nAlphanumeric\n\nThe unique PSP reference identifier for\u00a0the original payment authorisation.\n\n6\nAlphabetic\n\nWhen the payment is not authorised, it is refused, or if an error occurs, this field holds Adyen's mapped reason for the refusal or a description of the error.\nPossible error messages:\n\nTransaction not found\nTransaction is expired\nInsufficient balance on payment\nOnly possible to refund the full amount\nOnly possible to capture the full amount\nModification in different currency than authorisation\nInternal error\nOperation not available\nOperation not allowed\nOperation failed\nRecurring not supported for this payment method\nRecurring transaction failed\nRecurring contract is not active\nRecurring contract not found\nRecurring initial payment not found\nRecurring initial payment not available\nRecurring contract already exists\nFund Transfer not supported for this payment method\nFund Transfer failed\nFund Transfer: initial payment not found\nFund Transfer: Original Transaction is never authorised\nThe payment details have expired\nFund Transfer: unable to transfer to this bankaccount\nInvoiceLines are incorrect\nIncomplete or invalid payment details\nNo suitable capture found for partial refund\nInvalid referral authorisation code\n\n\nExample\nFH,1.0,TEST,Company,TestCompany,Default,1,ws@Company.TestCompany,Modification,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,Capture,9874560210158741,Success,\nSL,1,ModificationResult,9874560210158741,9248732154865245,\nL,2,MerchantAccount,TestMerchant,Capture,9541236985175236,Error,EchoData1\nSL,1,ModificationResult,9541236985175236,9248732154851572,Transaction not found\nL,3,MerchantAccount,TestMerchant,Refund,95412367785175236,Error,EchoData2\nSL,1,ModificationResult,95412367785175236,9358752154851572,Insufficient balance on payment\nBT,3\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 result file","lvl5":"Modification result 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-result-file","lvl5":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-result-file\/modification-result-file"},"levels":6,"category":"Development Resources","category_color":"green","tags":["Modification","result"]}}