Tools-2 icon

Authorisation result file

When parsing or validation errors occur, the result file has the structure described in batch result files with validation errors.

Authorisation line

The line record [L] holds the metadata information that applies to its corresponding sub-line [SL] records.

Field #

Format

Description

1

Fixed value: L

Record type identifier

2

Numeric

`L` line record number reference within the batch file block it belongs to.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: MerchantAccount

Account type.
Defines the type of account the transactions are related to.

4

Alphanumeric

Specifies the merchant account name.

5

Fixed value: Authorisation

Processing type.
Defines the type of action that is required for the specified transaction.

If the column shows ValidationError, then the file shall have the structure of the batch result file (ValidationError) instead.

6

Alphanumeric

A merchant reference, that is, a unique identifier associated to a specific transaction.

7

Allowed values:

  • Success
  • Authorised
  • Refused
  • Cancelled
  • Received
  • Error

Transaction status.

8

Alphanumeric

EchoData
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 Adyen payments platform does not use this data.
Maximum character length: 80 characters.

Authorisation sub-line

Field #

Format

Description

1

Fixed value: SL

Record type identifier.

2

Numeric

`SL` sub-line record number reference within its parent line.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: PaymentResult

Result type identifier.

4

Alphanumeric

The original payment PSP reference.

5

[A-Za-z0-9.-? ]+

Authorisation code: 

  • When the payment is authorised successfully, this field holds the authorisation code for the payment. 
  • When the payment is not authorised, this field is empty.

6

Alphanumeric

Result code, if available.

7

Alphabetic

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.

Possible error messages:

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

Example

FH,1.0,TEST,Company,TestCompany,Default,206,ws@Company.TestCompany,Authorisation,FileHeaderEchoData 
BH,1,BlockHeaderEchoData 
L,1,MerchantAccount,TestMerchant,Authorisation,9874563210158741,Authorised,EchoData
SL,1,PaymentResult,9874563210158741,85421,100,Approved
L,2,MerchantAccount,TestMerchant,Authorisation,9874563210157874,Refused,
SL,1,PaymentResult,9874563210157874,,140,Invalid expiry date
BT,2 
FT,1