---
title: "Payout request"
url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payout-request-file/payout-request"
source_url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payout-request-file/payout-request.md"
canonical: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payout-request-file/payout-request"
last_modified: "2019-04-30T16:41:00+02:00"
language: "en"
---

# Payout request

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

## Mandatory sub-lines

The [`PayoutDetails` ](#payoutdetails)and [`Recurring` ](#recurring)sub-lines described below are mandatory when submitting a payout authorisation request. You also need to include either a [ `Card` ](#card), [ `BankAccount` ](#bankaccount), or [ `IBAN` ](#iban) sub-line on your payout request.

### PayoutDetails

| **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: `PayoutDetails`                 | ![-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                                 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A shopper's reference, which is the unique identifier for a shopper.                                                               |
| 8           | Email address                                | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | 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          | YYYY-MM-DD                                   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The shopper's birth date.                                                                                                          |
| 12          | Numeric                                      | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | The shopper's social security number.                                                                                              |
| 13          | Allowed values:- `NaturalPerson`
- `Company` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The type of the entity the payout is processed for.                                                                                |
| 14          | Alphabetic                                   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The shopper's nationality.A valid value is an ISO 2-character country code (e.g. 'NL').                                            |

### Recurring

| 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: `Recurring` | ![-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       | Fixed value: `PAYOUT`    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The type of recurring payment.                                                                                                    |
| 5       | Fixed value: `Latest`    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Fixed value.                                                                                                                      |

### Card

Besides the required `PayoutDetails` and `Recurring` sub-lines described above, a payout request needs to include either a `Card`, `BankAccount`, or `IBAN` payment method.

For this payout, you need a user role with permission to store payout details.

* This sub-line holds information about card payments.
* In an authorization request for card payments, the `Card` sub-line needs to be submitted as *sub-line 2*.

| **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: `Card` | ![-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-") | Card number.                                                                                                                                        |
| 5           | Numeric             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Expiry month.* Format: `MM`, zero-padded (eg: *03*)                                                                                                 |
| 6           | Numeric             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Expiry year.* Format: `YYYY` (eg: *2016*)                                                                                                           |
| 7           | Numeric             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | [CVC code](https://www.cvvnumber.com/cvv.html).* Three-digit CVC/CVV code (Visa, Mastercard, Discover)
* Four-digit CVC/CVV code (American Express) |
| 8           | Alphanumeric        | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Cardholder name.                                                                                                                                    |
| 9           | Numeric             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Start month.* Format: `MM`, zero-padded (eg: *03*)Maestro UK only.                                                                                  |
| 10          | Numeric             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Start year.* Format: `YYYY` (eg: *2016*)Maestro UK only.                                                                                            |
| 11          | Numeric             | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | One-digit card issue number.Maestro UK only.                                                                                                        |

```text
FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData 
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,Payout,MerchantReference,
SL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL
SL,2,Card,4444333322221111,12,2012,J. de Tester,,,
SL,3,Recurring,PAYOUT,LATEST
BT,1 
FT,1
```

### BankAccount

Besides the required `PayoutDetails` and `Recurring` sub-lines described above, a payout request needs to include either a `Card`, `BankAccount`, or `IBAN` payment methods.

For this payout, you need a user role with permission to store payout details.

* This sub-line holds information about bank transfer payments carried out using the shopper's bank account details.
* In an authorisation request for bank account payments, the `BankAccount` sub-line needs to be submitted as *sub-line 2*.

| **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: `BankAccount` | ![-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-") | Bank account owner name.                                                                                                                                                                                                                                                                                         |
| 5           | Alphabetic                 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Two-letter country code. The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. |
| 6           | Numeric                    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Bank account number.                                                                                                                                                                                                                                                                                             |
| 7           | Alphabetic                 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Two-letter bank location.* Format: `AA`                                                                                                                                                                                                                                                                          |
| 8           | Alphabetic                 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Two-letter bank name.* Format: `AA`                                                                                                                                                                                                                                                                              |
| 9           | Numeric                    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Bank code.                                                                                                                                                                                                                                                                                                       |
| 10          | Alphabetic                 | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Two-letter check code.* Format: `AA`                                                                                                                                                                                                                                                                             |

```text
FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData 
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,Payout,MerchantReference,
SL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL
SL,2,BankAccount,Simon Hopper,SE,123456789,20010020,Postbank Stockholm,3125876,Hameln
SL,3,Recurring,PAYOUT,LATEST
BT,1 
FT,1
```

### IBAN

Besides the required `PayoutDetails` and `Recurring` sub-lines described above, a payout request needs to include either a `Card`, `BankAccount`, or `IBAN` payment methods.

For this payout, you need a user role with permission to store payout details.

* This sub-line holds information about bank transfer or SEPA Direct Debit (DD) payments carried out using the shopper's IBAN details.
* In an authorization request for IBAN payments, the `IBAN` sub-line needs to be submitted as *sub-line 2*.

| 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: `IBAN`                                            | ![-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 Cannot be only numbers. Minimum three characters. | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Bank account owner name. If provided details do not match the required format, the response returns the error message: 203 'Invalid bank account holder name'.                                                                                                                                                   |
| 5       | Alphabetic                                                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Two-letter country code. The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. |
| 6       | Alphanumeric                                                   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | [IBAN code](https://en.wikipedia.org/wiki/International_Bank_Account_Number).                                                                                                                                                                                                                                    |
| 7       | Alphanumeric                                                   | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | [BIC code](https://en.wikipedia.org/wiki/ISO_9362).                                                                                                                                                                                                                                                              |

```text
FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData 
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,Payout,MerchantReference,
SL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL
SL,2,IBAN,A. Klaassen,NL,NL13TEST0123456789,
SL,3,Recurring,PAYOUT,LATEST
BT,1 
FT,1
```
