---
title: "AuthorisationReferral request"
url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/authorisationreferral-request"
source_url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/authorisationreferral-request.md"
canonical: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/authorisationreferral-request"
last_modified: "2019-04-30T17:21:00+02:00"
language: "en"
---

# AuthorisationReferral request

[View source](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/authorisationreferral-request.md)

When you process [MOTO transactions](/online-payments/classic-integrations/hosted-payment-pages/skin/moto-feature), 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](https://docs.adyen.com/api-explorer/#/Payment/latest/authorise__section_resParams) 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.

![](/user/pages/docs/13.development-resources/14.batch-processing/03.advanced-sftp-batch-files/03.batch-request-file/02.modification-request-file/01.authorisationreferral-request/AuthorisationReferral-request.png)

## Mandatory sub-lines

The [`PaymentDetails` ](#paymentdetails)and [`AuthoriseReferral` ](#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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Record type identifier                                                                                                                                                                                                       |
| 2           | Numeric                       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Transaction type. Defines the required field types for the specific sub-line.                                                                                                                                                |
| 4           | Numeric                       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Amount.                                                                                                                                                                                                                      |
| 5           | Numeric                       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The [currency exponent](https://en.wikipedia.org/wiki/ISO_4217#Treatment_of_minor_currency_units_.28the_.22exponent.22.29).                                                                                                  |
| 6           | Alphabetic                    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The three-character [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217).                                                                                                                                             |
| 7           | Alphanumeric                  | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | A shopper's reference, which is the unique identifier for a shopper.Required element for recurring payments and to create [recurring contracts](/online-payments/classic-integrations/classic-api-integration/tokenization). |
| 8           | Email address                 | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | The shopper's email address.                                                                                                                                                                                                 |
| 9           | Alphanumeric                  | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Shopper statement. The soft [descriptor](https://en.wikipedia.org/wiki/Billing_descriptor) for the transaction.                                                                                                              |
| 10          | IP address                    | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | The IP address the shopper used to carry out the transaction.                                                                                                                                                                |
| 11          | Numeric                       | ![-x-](/user/data/smileys/emoji/x.png "-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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Record type identifier                                                                                                               |
| 2           | Numeric                          | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-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-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Transaction type. Defines the required field types for the specific sub-line.                                                        |
| 4           | Alphanumeric                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The original payment PSP reference.                                                                                                  |
| 5           | Alphanumeric                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The authorisation code for the transaction (authCode).                                                                               |

```text
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
```
