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, see the 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.
Batch line
The line record [L] holds the metadata information that applies to its corresponding sub-line [SL] records.
Field # | Format | Description |
---|---|---|
1 |
Fixed value: |
Record type identifier. |
2 |
Numeric | `L` line record number reference within the batch file block it belongs to. |
3 |
Fixed value: |
Account type. |
4 |
Alphanumeric |
Specifies the merchant account name. |
5 |
Fixed value: |
Indicates that an error occurs while processing the batch request. |
6 |
Alphanumeric |
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 corresponding request file. |
7 |
Fixed value: |
Indicates that an error occurs while processing the batch request. |
8 |
Alphanumeric |
|
Batch sub-line
Field # | Format | Description |
---|---|---|
1 |
Fixed value: |
Record type identifier. |
2 |
Numeric | `SL` sub-line record number reference within its parent line. |
3 |
Fixed value: | Indicates that an error occurs while processing the batch request. |
4 |
Empty |
This value must be empty. |
5 |
Alphanumeric |
The description of the error message. Possible values:
For the full list, refer to Response handling (Error codes returned). |
Examples
The following example shows the response when invalid amount was specified in a modification request:
L,1,MerchantAccount,TestMerchant,ParseOrValidationError,N/A,ValidationError,
SL,1,ValidationErrorResult,,Invalid amount specified
The example below shows the response when a PSP reference was missing in a modification request:
L,1,MerchantAccount,TestMerchant,ParseOrValidationError,441231,ValidationError,
SL,1,ValidationErrorResult,,Original pspReference required for this operation
The following example shows the response when an invalid merchant account was specified in an Account Updater request:
L,14,MerchantAccount,N/A,ParseOrValidationError,441231,ValidationError,
SL,1,ValidationErrorResult,,Invalid Merchant Account