{"title":"StoreToken request for payout","category":"default","creationDate":1779620072,"content":"<h2 id=\"mandatory-sub-lines\">Mandatory sub-lines<\/h2>\n<p>The <a href=\"#shopperdetails\">\n  <code>ShopperDetails<\/code>\n<\/a> and <a href=\"#recurring\">\n  <code>Recurring<\/code>\n<\/a> sub-lines described below are mandatory when submitting a <code>StoreToken<\/code> request.\u00a0You also need to include either a\u00a0<a href=\"#card\">\n  <code>Card<\/code>\n<\/a>,\u00a0<a href=\"#bankaccount\">\n  <code>BankAccount<\/code>\n<\/a>, or\u00a0<a href=\"#iban\">\n  <code>IBAN<\/code>\n<\/a>\u00a0sub-line on your\u00a0<code>StoreToken<\/code> request.<\/p>\n<ul>\n<li><code>StoreToken<\/code>\u00a0enables <a href=\"https:\/\/en.wikipedia.org\/wiki\/Tokenization_(data_security)\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">tokenising<\/a> payment details.<\/li>\n<li>Only payment requests submitted after sending the\u00a0<code>StoreToken<\/code> request are tokenised.<\/li>\n<\/ul>\n<h3 id=\"shopperdetails\">ShopperDetails<\/h3>\n<p><div class=\"sc-notice info\"><div> This sub-line specifies transaction amount and customer details. <br \/><br \/>\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<table>\n<thead>\n<tr>\n<th>Field #<\/th>\n<th>Format<\/th>\n<th>Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Fixed value: <code>SL<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Record type identifier<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Numeric<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td><code>SL<\/code> sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Fixed value: <code>ShopperDetails<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Transaction type. <br \/>Defines the required field types for the specific sub-line.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Alphanumeric<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>A shopper's reference, which is the unique identifier for a shopper.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Email address<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The shopper's email address.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"recurring\">Recurring<\/h3>\n<div class=\"sc-notice info\"><div>\n<p>If you include this subline in your batch file, a recurring payment request is created with the provided payment details.<\/p>\n<\/div><\/div>\n<table>\n<thead>\n<tr>\n<th>Field #<\/th>\n<th>Format<\/th>\n<th>Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Fixed value: <code>SL<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Record type identifier<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Numeric<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td><code>SL<\/code> sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Fixed value:\u00a0<code>Recurring<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Transaction type. <br \/>Defines the required field types for the specific sub-line.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Fixed value:\u00a0<code>PAYOUT<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The type of recurring payment.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Fixed value: <code>Latest<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Fixed value.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"card\">Card<\/h3>\n<p>Besides the required\u00a0<a href=\"#shopperdetails\">\n  <code>ShopperDetails<\/code>\n<\/a> and <a href=\"#recurring\">\n  <code>Recurring<\/code>\n<\/a> \u00a0sub-lines described above,\u00a0a\u00a0<code>StoreToken<\/code>\u00a0request needs to include\u00a0either a\u00a0<a href=\"#card\">\n  <code>Card<\/code>\n<\/a>,\u00a0<a href=\"#bankaccount\">\n  <code>BankAccount<\/code>\n<\/a>, or\u00a0<a href=\"#iban\">\n  <code>IBAN<\/code>\n<\/a>\u00a0payment method.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>For this StoreToken, you need a <a href=\"\/online-payments\/online-payouts\">user role<\/a> with permission to store payout details.<\/p>\n<\/div><\/div>\n<div class=\"sc-notice info\"><div>\n<ul>\n<li>This sub-line holds information about card payments.<\/li>\n<li>In an authorisation request for card payments, the\u00a0<code>Card<\/code> sub-line needs to be submitted as <em>sub-line 2<\/em>.<\/li>\n<\/ul>\n<\/div><\/div>\n<table><thead><tr class=\"header\"><th><p><strong>Field #<\/strong><\/p><\/th><th><p><strong>Format<\/strong><\/p><\/th><th><p><strong>Required<\/strong><\/p><\/th><th><p><strong>Description<\/strong><\/p><\/th><\/tr><\/thead><tbody><tr><td>\n<p>1<\/p>\n<\/td><td>\n<p>Fixed value: <code>SL<\/code><\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Record type identifier<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>`SL` sub-line record number reference within its parent line.<br>\nThe counter starts at 1, and it increments sequentially by one unit.<\/td><\/tr><tr><td>\n<p>3<\/p>\n<\/td><td>\n<p>Fixed value:\u00a0<code>Card<\/code><\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Transaction type. <br>Defines the required field types for the specific sub-line.<\/p>\n<\/td><\/tr><tr><td>\n<p>4<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Card number.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Expiry month.<ul><li markdown=\"1\">Format: <code>MM<\/code>, zero-padded (ex.: <em>03<\/em>)<\/li><\/ul><\/p>\n<\/td><\/tr><tr><td>\n<p>6<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Expiry year.<ul><li markdown=\"1\"><ul><li markdown=\"1\">Format: <code>YYYY<\/code> (ex.: <em>2016<\/em>)<\/li><\/ul><\/li><\/ul><\/p>\n<\/td><\/tr><tr><td>\n<p>7<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td><p><a href=\"https:\/\/www.cvvnumber.com\/cvv.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">CVC code<\/a>.<br>\nLeave this field blank.<\/p><\/td><\/tr><tr><td>\n<p>8<\/p>\n<\/td><td>\n<p>Alphanumeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Card holder name.<\/p>\n<\/td><\/tr><tr><td>\n<p>9<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Start month.<ul><li markdown=\"1\">Format: <code>MM<\/code>, zero-padded (ex.: <em>03<\/em>)<\/li><\/ul><div class=\"sc-notice info\"><div><p>Maestro UK only.<\/p><\/div><\/div><\/p>\n<\/td><\/tr><tr><td>\n<p>10<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Start year.<ul><li markdown=\"1\">Format: <code>YYYY<\/code> (ex.: <em>2016<\/em>)<\/li><\/ul><div class=\"sc-notice info\"><div><p>Maestro UK only.<\/p><\/div><\/div><\/p>\n<\/td><\/tr><tr><td>\n<p>11<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>One-digit card issue number.<div class=\"sc-notice info\"><div>Maestro UK only.<\/div><\/div><\/p>\n<\/td><\/tr><\/tbody><\/table>\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,StoreToken,MerchantReference,\nSL,1,ShopperDetails,test@adyen.com,test@adyen.com\nSL,2,Card,4444333322221111,12,2012,,J. de Tester,,,\nSL,3,Recurring,PAYOUT,Latest\nBT,1\nFT,1<\/code><\/pre>\n<h3 id=\"bankaccount\">BankAccount<\/h3>\n<p>Besides the required\u00a0<a href=\"#shopperdetails\">\n  <code>ShopperDetails<\/code>\n<\/a> and <a href=\"#recurring\">\n  <code>Recurring<\/code>\n<\/a> \u00a0sub-lines described above,\u00a0a\u00a0<code>StoreToken<\/code>\u00a0request needs to include\u00a0either a\u00a0<a href=\"#card\">\n  <code>Card<\/code>\n<\/a>,\u00a0<a href=\"#bankaccount\">\n  <code>BankAccount<\/code>\n<\/a>, or\u00a0<a href=\"#iban\">\n  <code>IBAN<\/code>\n<\/a>\u00a0payment method.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>For this StoreToken, you need a <a href=\"\/online-payments\/online-payouts\">user role<\/a> with permission to store payout details.<\/p>\n<\/div><\/div>\n<div class=\"sc-notice info\"><div>\n<ul>\n<li>This sub-line holds information about bank transfer payments carried out using the shopper's bank account details.<\/li>\n<li>In an authorisation request for bank account payments, the\u00a0<code>BankAccount<\/code> sub-line needs to be submitted as <em>sub-line 2<\/em>.<\/li>\n<\/ul>\n<\/div><\/div>\n<table><thead><tr class=\"header\"><th><p><strong>Field #<\/strong><\/p><\/th><th><p><strong>Format<\/strong><\/p><\/th><th><p><strong>Required<\/strong><\/p><\/th><th><p><strong>Description<\/strong><\/p><\/th><\/tr><\/thead><tbody><tr><td>\n<p>1<\/p>\n<\/td><td>\n<p>Fixed value: <code>SL<\/code><\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Record type identifier<\/p>\n<\/td><\/tr><tr><td>\n<p>2<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p><code>SL<\/code> sub-line record number reference within its parent line.<br>The counter starts at 1, and it increments sequentially by one unit.<\/p>\n<\/td><\/tr><tr><td>\n<p>3<\/p>\n<\/td><td>\n<p>Fixed value:\u00a0<code>BankAccount<\/code><\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Transaction type. <br>Defines the required field types for the specific sub-line.<\/p>\n<\/td><\/tr><tr><td>\n<p>4<\/p>\n<\/td><td>\n<p>Alphanumeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Bank account owner name.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/p>\n<\/td><td>\n<p>Alphabetic<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Two-letter country code.<br>The <code>country<\/code> value format needs to adhere to the <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-1 alpha-2<\/a> standard.\u00a0An invalid country code results in a transaction\/request rejection.\u00a0You can <a href=\"https:\/\/www.iso.org\/obp\/ui\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">look up country codes<\/a> on the ISO website.<\/p>\n<\/td><\/tr><tr><td>\n<p>6<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Bank account number.<\/p>\n<\/td><\/tr><tr><td>\n<p>7<\/p>\n<\/td><td>\n<p>Alphabetic<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Two-letter bank location.<ul><li markdown=\"1\">Format: <code>AA<\/code><\/li><\/ul><\/p>\n<\/td><\/tr><tr><td>\n<p>8<\/p>\n<\/td><td>\n<p>Alphabetic<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Two-letter bank name.<ul><li markdown=\"1\">Format: <code>AA<\/code><\/li><\/ul><\/p>\n<\/td><\/tr><tr><td>\n<p>9<\/p>\n<\/td><td>\n<p>Numeric<\/p>\n<\/td><td>\n<p><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p>Bank code.<\/p>\n<\/td><\/tr><tr><td>\n<p>10<\/p>\n<\/td><td>\n<p>Alphabetic<\/p>\n<\/td><td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td><td>\n<p>Two-letter check code.<ul><li markdown=\"1\">Format: <code>AA<\/code><\/li><\/ul><\/p>\n<\/td><\/tr><\/tbody><\/table>\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,StoreToken,MerchantReference,\nSL,1,ShopperDetails,test@adyen.com,test@adyen.com\nSL,2,BankAccount,Simon Hopper,SE,123456789,20010020,Postbank Stockholm,3125876,Hameln\nSL,3,Recurring,PAYOUT,Latest\nBT,1\nFT,1<\/code><\/pre>\n<h3 id=\"iban\">IBAN<\/h3>\n<p>Besides the required\u00a0<a href=\"#shopperdetails\">\n  <code>ShopperDetails<\/code>\n<\/a> and <a href=\"#recurring\">\n  <code>Recurring<\/code>\n<\/a> \u00a0sub-lines described above,\u00a0a\u00a0<code>StoreToken<\/code>\u00a0request needs to include\u00a0either a\u00a0<a href=\"#card\">\n  <code>Card<\/code>\n<\/a>,\u00a0<a href=\"#bankaccount\">\n  <code>BankAccount<\/code>\n<\/a>, or\u00a0<a href=\"#iban\">\n  <code>IBAN<\/code>\n<\/a>\u00a0payment method.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>For this StoreToken, you need a <a href=\"\/online-payments\/online-payouts\">user role<\/a> with permission to store payout details.<\/p>\n<\/div><\/div>\n<div class=\"sc-notice info\"><div>\n<ul>\n<li>This sub-line holds information about bank transfer or SEPA Direct Debit (DD) payments carried out using the shopper's IBAN details.<\/li>\n<li>In an authorization request for IBAN payments, the <code>IBAN<\/code> sub-line needs to be submitted as <em>sub-line 2<\/em>.\n<\/div><\/div><\/li>\n<\/ul>\n<table>\n<thead>\n<tr>\n<th>Field #<\/th>\n<th>Format<\/th>\n<th>Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Fixed value: <code>SL<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Record type identifier<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Numeric<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td><code>SL<\/code> sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Fixed value: <code>IBAN<\/code><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Transaction type. <br \/>Defines the required field types for the specific sub-line.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Alphanumeric<br \/>Cannot be only numbers. Minimum three characters.<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Bank account owner name.<br \/><div class=\"sc-notice info\"><div>If provided details do not match the required format, the response returns the error message: 203 'Invalid bank account holder name'.<\/div><\/div><\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Alphabetic<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Two-letter country code.<br \/>The <code>country<\/code> value format needs to adhere to the <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-1 alpha-2<\/a> standard.\u00a0An invalid country code results in a transaction\/request rejection.\u00a0You can <a href=\"https:\/\/www.iso.org\/obp\/ui\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">look up country codes<\/a> on the ISO website.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>Alphanumeric<\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td><a href=\"https:\/\/en.wikipedia.org\/wiki\/International_Bank_Account_Number\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">IBAN code<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>Alphanumeric<\/td>\n<td><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<td><a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_9362\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">BIC code<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,StoreToken,MerchantReference,\nSL,1,ShopperDetails,test@adyen.com,test@adyen.com\nSL,2,IBAN,A. Klaassen,NL,NL13TEST0123456789,\nSL,3,Recurring,PAYOUT,Latest\nBT,1\nFT,1<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/storetoken-request-file\/storetoken-request-for-payout","articleFields":{"id":"24216667","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"30-04-2019 17:37"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/storetoken-request-file\/storetoken-request-for-payout","title":"StoreToken request for payout","content":"Mandatory sub-lines\nThe \n  ShopperDetails\n and \n  Recurring\n sub-lines described below are mandatory when submitting a StoreToken request.\u00a0You also need to include either a\u00a0\n  Card\n,\u00a0\n  BankAccount\n, or\u00a0\n  IBAN\n\u00a0sub-line on your\u00a0StoreToken request.\n\nStoreToken\u00a0enables tokenising payment details.\nOnly payment requests submitted after sending the\u00a0StoreToken request are tokenised.\n\nShopperDetails\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. \n\n\n\nField #\nFormat\nRequired\nDescription\n\n\n\n\n1\nFixed value: SL\n\nRecord type identifier\n\n\n2\nNumeric\n\nSL sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.\n\n\n3\nFixed value: ShopperDetails\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n\n4\nAlphanumeric\n\nA shopper's reference, which is the unique identifier for a shopper.\n\n\n5\nEmail address\n\nThe shopper's email address.\n\n\n\nRecurring\n\nIf you include this subline in your batch file, a recurring payment request is created with the provided payment details.\n\n\n\n\nField #\nFormat\nRequired\nDescription\n\n\n\n\n1\nFixed value: SL\n\nRecord type identifier\n\n\n2\nNumeric\n\nSL sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.\n\n\n3\nFixed value:\u00a0Recurring\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n\n4\nFixed value:\u00a0PAYOUT\n\nThe type of recurring payment.\n\n\n5\nFixed value: Latest\n\nFixed value.\n\n\n\nCard\nBesides the required\u00a0\n  ShopperDetails\n and \n  Recurring\n \u00a0sub-lines described above,\u00a0a\u00a0StoreToken\u00a0request needs to include\u00a0either a\u00a0\n  Card\n,\u00a0\n  BankAccount\n, or\u00a0\n  IBAN\n\u00a0payment method.\n\nFor this StoreToken, you need a user role with permission to store payout details.\n\n\n\nThis sub-line holds information about card payments.\nIn an authorisation request for card payments, the\u00a0Card sub-line needs to be submitted as sub-line 2.\n\n\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:\u00a0Card\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nNumeric\n\n\n\nCard number.\n\n5\n\nNumeric\n\n\n\nExpiry month.Format: MM, zero-padded (ex.: 03)\n\n6\n\nNumeric\n\n\n\nExpiry year.Format: YYYY (ex.: 2016)\n\n7\n\nNumeric\n\n\nCVC code.\nLeave this field blank.\n8\n\nAlphanumeric\n\n\n\nCard holder name.\n\n9\n\nNumeric\n\n\n\nStart month.Format: MM, zero-padded (ex.: 03)Maestro UK only.\n\n10\n\nNumeric\n\n\n\nStart year.Format: YYYY (ex.: 2016)Maestro UK only.\n\n11\n\nNumeric\n\n\n\nOne-digit card issue number.Maestro UK only.\n\nFH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,StoreToken,MerchantReference,\nSL,1,ShopperDetails,test@adyen.com,test@adyen.com\nSL,2,Card,4444333322221111,12,2012,,J. de Tester,,,\nSL,3,Recurring,PAYOUT,Latest\nBT,1\nFT,1\nBankAccount\nBesides the required\u00a0\n  ShopperDetails\n and \n  Recurring\n \u00a0sub-lines described above,\u00a0a\u00a0StoreToken\u00a0request needs to include\u00a0either a\u00a0\n  Card\n,\u00a0\n  BankAccount\n, or\u00a0\n  IBAN\n\u00a0payment method.\n\nFor this StoreToken, you need a user role with permission to store payout details.\n\n\n\nThis sub-line holds information about bank transfer payments carried out using the shopper's bank account details.\nIn an authorisation request for bank account payments, the\u00a0BankAccount sub-line needs to be submitted as sub-line 2.\n\n\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:\u00a0BankAccount\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nAlphanumeric\n\n\n\nBank account owner name.\n\n5\n\nAlphabetic\n\n\n\nTwo-letter country code.The country value format needs to adhere to the ISO 3166-1 alpha-2 standard.\u00a0An invalid country code results in a transaction\/request rejection.\u00a0You can look up country codes on the ISO website.\n\n6\n\nNumeric\n\n\n\nBank account number.\n\n7\n\nAlphabetic\n\n\n\nTwo-letter bank location.Format: AA\n\n8\n\nAlphabetic\n\n\n\nTwo-letter bank name.Format: AA\n\n9\n\nNumeric\n\n\n\nBank code.\n\n10\n\nAlphabetic\n\n\n\nTwo-letter check code.Format: AA\n\nFH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,StoreToken,MerchantReference,\nSL,1,ShopperDetails,test@adyen.com,test@adyen.com\nSL,2,BankAccount,Simon Hopper,SE,123456789,20010020,Postbank Stockholm,3125876,Hameln\nSL,3,Recurring,PAYOUT,Latest\nBT,1\nFT,1\nIBAN\nBesides the required\u00a0\n  ShopperDetails\n and \n  Recurring\n \u00a0sub-lines described above,\u00a0a\u00a0StoreToken\u00a0request needs to include\u00a0either a\u00a0\n  Card\n,\u00a0\n  BankAccount\n, or\u00a0\n  IBAN\n\u00a0payment method.\n\nFor this StoreToken, you need a user role with permission to store payout details.\n\n\n\nThis sub-line holds information about bank transfer or SEPA Direct Debit (DD) payments carried out using the shopper's IBAN details.\nIn an authorization request for IBAN payments, the IBAN sub-line needs to be submitted as sub-line 2.\n\n\n\n\n\nField #\nFormat\nRequired\nDescription\n\n\n\n\n1\nFixed value: SL\n\nRecord type identifier\n\n\n2\nNumeric\n\nSL sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.\n\n\n3\nFixed value: IBAN\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n\n4\nAlphanumericCannot be only numbers. Minimum three characters.\n\nBank account owner name.If provided details do not match the required format, the response returns the error message: 203 'Invalid bank account holder name'.\n\n\n5\nAlphabetic\n\nTwo-letter country code.The country value format needs to adhere to the ISO 3166-1 alpha-2 standard.\u00a0An invalid country code results in a transaction\/request rejection.\u00a0You can look up country codes on the ISO website.\n\n\n6\nAlphanumeric\n\nIBAN code.\n\n\n7\nAlphanumeric\n\nBIC code.\n\n\n\nFH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,StoreToken,MerchantReference,\nSL,1,ShopperDetails,test@adyen.com,test@adyen.com\nSL,2,IBAN,A. Klaassen,NL,NL13TEST0123456789,\nSL,3,Recurring,PAYOUT,Latest\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":"StoreToken request file","lvl6":"StoreToken request for payout"},"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\/storetoken-request-file","lvl6":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/storetoken-request-file\/storetoken-request-for-payout"},"levels":7,"category":"Development Resources","category_color":"green","tags":["StoreToken","request","payout"]}}