{"title":"AuthorisationReferral request","category":"default","creationDate":1779620072,"content":"

When you process MOTO transactions<\/a>, you may need to handle transactions with a resulting\u00a0Declined<\/code> status and a corresponding\u00a0Referral<\/code> reason.<\/p>\n

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

When we receive and process the batch file, we book a new\u00a0Authorised<\/code> journal entry for the transaction and then proceed with the standard workflow.<\/p>\n

\"\"<\/p>\n

Mandatory sub-lines<\/h2>\n

The \n PaymentDetails<\/code>\n<\/a> and \n AuthoriseReferral<\/code>\n<\/a> sub-lines described below are mandatory when submitting a\u00a0bank transfer authorisation request.<\/p>\n

PaymentDetails<\/h3>\n

This sub-line specifies transaction amount and customer details.

\nOptional 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.<\/div><\/div><\/p>\n

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

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

Required<\/strong><\/p><\/th>

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

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

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

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

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

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

Transaction type.
Defines the required field types for the specific sub-line.<\/p>\n<\/td><\/tr>

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

Amount.<\/p>\n<\/td><\/tr>

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The currency exponent<\/a>.<\/p>\n<\/td><\/tr>

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The three-character ISO currency code<\/a>.<\/p>\n<\/td><\/tr>

\n

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

\n

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

\n

\"-x-\"<\/p>\n<\/td>

\n

A shopper's reference, which is the unique identifier for a shopper.

Required element for\u00a0recurring payments\u00a0and to create\u00a0recurring contracts<\/a>.<\/div><\/div><\/p>\n<\/td><\/tr>
\n

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

\n

Email address<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The shopper's email address.<\/p>\n<\/td><\/tr>

\n

9<\/p>\n<\/td>

\n

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

\n

\"-x-\"<\/p>\n<\/td>

\n

Shopper statement.
\nThe soft descriptor<\/a> for the transaction.<\/p>\n<\/td><\/tr>

\n

10<\/p>\n<\/td>

\n

IP address<\/p>\n<\/td>

\n

\"-x-\"<\/p>\n<\/td>

\n

The IP address the shopper used to carry out the transaction.<\/p>\n<\/td><\/tr>

\n

11<\/p>\n<\/td>

\n

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

\n

\"-x-\"<\/p>\n<\/td>

\n

Fraud offset.
\nThe value to be applied to offset the calculated risk score.
\nIt can be either a positive or a negative value.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

AuthoriseReferral<\/h3>\n

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

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

Required<\/strong><\/p><\/th>

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

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

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

\n

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

\n

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

\n

\"-white_check_mark-\"<\/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: AuthoriseReferral<\/code><\/p>\n<\/td>

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

Transaction type.
Defines the required field types for the specific sub-line.<\/p>\n<\/td><\/tr>

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The original payment PSP reference.<\/p>\n<\/td><\/tr>

\n

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

\n

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

\n

\"-white_check_mark-\"<\/p>\n<\/td>

\n

The authorisation code for the transaction (authCode).<\/p>\n<\/td><\/tr><\/tbody><\/table>\n

FH,1.0,TEST,Company,TestCompany,Default,2,ws@Company.TestCompany,Modification,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,AuthoriseReferral,Test Product 6,\nSL,1,PaymentDetails,100,2,EUR,,,,,\nSL,2,AuthoriseReferral,8452147851579029,259016\nBT,1\nFT,1<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/modification-request-file\/authorisationreferral-request","articleFields":{"id":"24216649","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"30-04-2019 17:21"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/modification-request-file\/authorisationreferral-request","title":"AuthorisationReferral request","content":"When you process MOTO transactions, you may need to handle transactions with a resulting\u00a0Declined status and a corresponding\u00a0Referral reason.\nIf 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.\nWhen we receive and process the batch file, we book a new\u00a0Authorised journal entry for the transaction and then proceed with the standard workflow.\n\nMandatory sub-lines\nThe \n  PaymentDetails\n and \n  AuthoriseReferral\n sub-lines described below are mandatory when submitting a\u00a0bank transfer authorisation request.\nPaymentDetails\nThis sub-line specifies transaction amount and customer details.\nOptional 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.\nField #FormatRequiredDescription\n1\n\nFixed value: SL\n\n\n\nRecord type identifier\n\n2\n\nNumeric\n\n\n\nSL sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.\n\n3\n\nFixed value:\u00a0PaymentDetails\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nNumeric\n\n\n\nAmount.\n\n5\n\nNumeric\n\n\n\nThe currency exponent.\n\n6\n\nAlphabetic\n\n\n\nThe three-character ISO currency code.\n\n7\n\nAlphanumeric\n\n\n\nA shopper's reference, which is the unique identifier for a shopper.Required element for\u00a0recurring payments\u00a0and to create\u00a0recurring contracts.\n\n8\n\nEmail address\n\n\n\nThe shopper's email address.\n\n9\n\nAlphanumeric\n\n\n\nShopper statement.\nThe soft descriptor for the transaction.\n\n10\n\nIP address\n\n\n\nThe IP address the shopper used to carry out the transaction.\n\n11\n\nNumeric\n\n\n\nFraud offset.\nThe value to be applied to offset the calculated risk score.\nIt can be either a positive or a negative value.\n\nAuthoriseReferral\nField #FormatRequiredDescription\n1\n\nFixed value: SL\n\n\n\nRecord type identifier\n\n2\n\nNumeric\n\n\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: AuthoriseReferral\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nAlphanumeric\n\n\n\nThe original payment PSP reference.\n\n5\n\nAlphanumeric\n\n\n\nThe authorisation code for the transaction (authCode).\n\nFH,1.0,TEST,Company,TestCompany,Default,2,ws@Company.TestCompany,Modification,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,AuthoriseReferral,Test Product 6,\nSL,1,PaymentDetails,100,2,EUR,,,,,\nSL,2,AuthoriseReferral,8452147851579029,259016\nBT,1\nFT,1","type":"page","locale":"en","boost":14,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Batch processing","lvl3":"Submit transaction batch files through SFTP","lvl4":"Batch request file","lvl5":"Modification request file","lvl6":"AuthorisationReferral request"},"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-request-file","lvl5":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/modification-request-file","lvl6":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/modification-request-file\/authorisationreferral-request"},"levels":7,"category":"Development Resources","category_color":"green","tags":["AuthorisationReferral","request"]},"articleFiles":{"AuthorisationReferral-request.png":"\"\""}}