Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

AuthorisationReferral request

When you process MOTO transactions, you may need to handle transactions with a resulting Declined status and a corresponding Referral reason.

If the shopper contacted their issuing bank and you have the authorisation code for the transaction, you can submit it in a batch file to update the transaction in the Adyen payments platform.

When we receive and process the batch file, we book a new Authorised journal entry for the transaction and then proceed with the standard workflow.

Mandatory sub-lines

The PaymentDetails and AuthoriseReferral sub-lines described below are mandatory when submitting a bank transfer authorisation request.

PaymentDetails

This sub-line specifies transaction amount and customer details.

Optional fields: if you do not populate one or more non-mandatory fields and leave them blank, you need in any case to insert delimiting commas because the Adyen payments platform expects a preset, fixed number of fields per line/sub-line.
Field # Format Required Description
1 Fixed value: SL -white_check_mark- Record type identifier
2 Numeric -white_check_mark- 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: PaymentDetails -white_check_mark- Transaction type.
Defines the required field types for the specific sub-line.
4 Numeric -white_check_mark- Amount.
5 Numeric -white_check_mark- The currency exponent.
6 Alphabetic -white_check_mark- The three-character ISO currency code.
7 Alphanumeric -x- A shopper's reference, which is the unique identifier for a shopper.
Required element for recurring payments and to create recurring contracts.
8 Email address -x- The shopper's email address.
Required element for recurring payments and to create recurring contracts.
9 Alphanumeric -x- Shopper statement.
The soft descriptor for the transaction.
10 IP address -x- The IP address the shopper used to carry out the transaction.
11 Numeric -x- Fraud offset.
The value to be applied to offset the calculated risk score.
It can be either a positive or a negative value.

AuthoriseReferral

Field # Format Required Description
1 Fixed value: SL -white_check_mark- Record type identifier
2 Numeric -white_check_mark- 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: AuthoriseReferral -white_check_mark- Transaction type.
Defines the required field types for the specific sub-line.
4 Alphanumeric -white_check_mark- The original payment PSP reference.
5 Alphanumeric -white_check_mark- The authorisation code for the transaction (authCode).
FH,1.0,TEST,Company,TestCompany,Default,2,ws@Company.TestCompany,Modification,FileHeaderEchoData
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,AuthoriseReferral,Test Product 6,
SL,1,PaymentDetails,100,2,EUR,,,,,
SL,2,AuthoriseReferral,8452147851579029,259016
BT,1
FT,1