--- title: "StoreToken request for payout" url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/storetoken-request-file/storetoken-request-for-payout" source_url: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/storetoken-request-file/storetoken-request-for-payout.md" canonical: "https://docs.adyen.com/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/storetoken-request-file/storetoken-request-for-payout" last_modified: "2019-04-30T17:37:00+02:00" language: "en" --- # StoreToken request for payout [View source](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/storetoken-request-file/storetoken-request-for-payout.md) ## Mandatory sub-lines The [`ShopperDetails` ](#shopperdetails)and [`Recurring` ](#recurring)sub-lines described below are mandatory when submitting a `StoreToken` request. You also need to include either a [ `Card` ](#card), [ `BankAccount` ](#bankaccount), or [ `IBAN` ](#iban) sub-line on your `StoreToken` request. * `StoreToken` enables [tokenising](https://en.wikipedia.org/wiki/Tokenization_\(data_security\)) payment details. * Only payment requests submitted after sending the `StoreToken` request are tokenised. ### ShopperDetails 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: `ShopperDetails` | ![-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-") | A shopper's reference, which is the unique identifier for a shopper. | | 5 | Email address | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The shopper's email address. | ### Recurring If you include this subline in your batch file, a recurring payment request is created with the provided payment details. | 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 [ `ShopperDetails` ](#shopperdetails)and [`Recurring` ](#recurring) sub-lines described above, a `StoreToken` request needs to include either a [ `Card` ](#card), [ `BankAccount` ](#bankaccount), or [ `IBAN` ](#iban) payment method. For this StoreToken, you need a [user role](/online-payments/online-payouts) with permission to store payout details. * This sub-line holds information about card payments. * In an authorisation 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 (ex.: *03*) | | 6 | Numeric | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Expiry year.* * Format: `YYYY` (ex.: *2016*) | | 7 | Numeric | ![-x-](/user/data/smileys/emoji/x.png "-x-") | [CVC code](https://www.cvvnumber.com/cvv.html). Leave this field blank. | | 8 | Alphanumeric | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Card holder name. | | 9 | Numeric | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Start month.* Format: `MM`, zero-padded (ex.: *03*)Maestro UK only. | | 10 | Numeric | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Start year.* Format: `YYYY` (ex.: *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,StoreToken,MerchantReference, SL,1,ShopperDetails,test@adyen.com,test@adyen.com SL,2,Card,4444333322221111,12,2012,,J. de Tester,,, SL,3,Recurring,PAYOUT,Latest BT,1 FT,1 ``` ### BankAccount Besides the required [ `ShopperDetails` ](#shopperdetails)and [`Recurring` ](#recurring) sub-lines described above, a `StoreToken` request needs to include either a [ `Card` ](#card), [ `BankAccount` ](#bankaccount), or [ `IBAN` ](#iban) payment method. For this StoreToken, you need a [user role](/online-payments/online-payouts) 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,StoreToken,MerchantReference, SL,1,ShopperDetails,test@adyen.com,test@adyen.com 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 [ `ShopperDetails` ](#shopperdetails)and [`Recurring` ](#recurring) sub-lines described above, a `StoreToken` request needs to include either a [ `Card` ](#card), [ `BankAccount` ](#bankaccount), or [ `IBAN` ](#iban) payment method. For this StoreToken, you need a [user role](/online-payments/online-payouts) 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,StoreToken,MerchantReference, SL,1,ShopperDetails,test@adyen.com,test@adyen.com SL,2,IBAN,A. Klaassen,NL,NL13TEST0123456789, SL,3,Recurring,PAYOUT,Latest BT,1 FT,1 ```