{"title":"Payout request","category":"default","creationDate":1779620072,"content":"<h2 id=\"mandatory-sub-lines\">Mandatory sub-lines<\/h2>\n<p>The <a href=\"#payoutdetails\">\n  <code>PayoutDetails<\/code>\n<\/a> and <a href=\"#recurring\">\n  <code>Recurring<\/code>\n<\/a> sub-lines described below are mandatory when submitting a payout authorisation 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\u00a0payout request.<\/p>\n<h3 id=\"payoutdetails\">PayoutDetails<\/h3>\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: <code>PayoutDetails<\/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>Amount.<\/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>The <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217#Treatment_of_minor_currency_units_.28the_.22exponent.22.29\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">currency exponent<\/a>.<\/p>\n<\/td><\/tr><tr><td>\n<p>6<\/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>The three-character <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO currency code<\/a>.<\/p>\n<\/td><\/tr><tr><td>\n<p>7<\/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>A shopper's reference, which is the unique identifier for a shopper.<\/p>\n<\/td><\/tr><tr><td>\n<p>8<\/p>\n<\/td><td>\n<p>Email address<\/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>The shopper's email address.<\/p>\n<\/td><\/tr><tr><td>\n<p>9<\/p>\n<\/td><td>\n<p>Alphanumeric<\/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>Shopper statement.<br \/>\nThe soft <a href=\"https:\/\/en.wikipedia.org\/wiki\/Billing_descriptor\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">descriptor<\/a> for the transaction.<\/p>\n<\/td><\/tr><tr><td>\n<p>10<\/p>\n<\/td><td>\n<p>IP address<\/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>The IP address the shopper used to carry out the transaction.<\/p>\n<\/td><\/tr><tr><td>\n<p>11<\/p>\n<\/td><td>\n<p>YYYY-MM-DD<\/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>The shopper's birth date.<\/p>\n<\/td><\/tr><tr><td>\n<p>12<\/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>The shopper's social security number.<\/p>\n<\/td><\/tr><tr><td>\n<p>13<\/p>\n<\/td><td>\n<p>Allowed values:<ul><li markdown=\"1\"><code>NaturalPerson<\/code><\/li><li markdown=\"1\"><code>Company<\/code><\/li><\/ul><\/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>The type of the entity the payout is processed for.\u00a0<\/p>\n<\/td><\/tr><tr><td>\n<p>14<\/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>The shopper's nationality.A valid value is an ISO 2-character country code (e.g. 'NL').<\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h3 id=\"recurring\">Recurring<\/h3>\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 <code>PayoutDetails<\/code>\u00a0and\u00a0<code>Recurring<\/code>\u00a0sub-lines described above, a payout request needs to include\u00a0either a\u00a0<code>Card<\/code>,\u00a0<code>BankAccount<\/code>, or\u00a0<code>IBAN<\/code>\u00a0payment method.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>For this payout, you need a user role 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 authorization 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 (eg: <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\">Format: <code>YYYY<\/code> (eg: <em>2016<\/em>)<\/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=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/p>\n<\/td><td>\n<p><a href=\"https:\/\/www.cvvnumber.com\/cvv.html\" class=\"external-link external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">CVC code<\/a>.<ul><li markdown=\"1\">Three-digit CVC\/CVV code (Visa, Mastercard, Discover)<\/li><li markdown=\"1\">Four-digit CVC\/CVV code (American Express)<\/li><\/ul><\/p>\n<\/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>Cardholder 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 (eg: <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> (eg: <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,Payout,MerchantReference,\nSL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL\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<code>PayoutDetails<\/code>\u00a0and\u00a0<code>Recurring<\/code>\u00a0sub-lines described above, a payout request needs to include\u00a0either a\u00a0<code>Card<\/code>,\u00a0<code>BankAccount<\/code>, or\u00a0<code>IBAN<\/code>\u00a0payment methods.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>For this payout, you need a user role 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,Payout,MerchantReference,\nSL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL\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<code>PayoutDetails<\/code>\u00a0and\u00a0<code>Recurring<\/code>\u00a0sub-lines described above, a payout request needs to include\u00a0either a\u00a0<code>Card<\/code>,\u00a0<code>BankAccount<\/code>, or\u00a0<code>IBAN<\/code>\u00a0payment methods.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>For this payout, you need a user role 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<!--->\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,Payout,MerchantReference,\nSL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL\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\/payout-request-file\/payout-request","articleFields":{"id":"24216659","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"30-04-2019 16:41"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/payout-request-file\/payout-request","title":"Payout request","content":"Mandatory sub-lines\nThe \n  PayoutDetails\n and \n  Recurring\n sub-lines described below are mandatory when submitting a payout authorisation 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\u00a0payout request.\nPayoutDetails\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: PayoutDetails\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.\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\nYYYY-MM-DD\n\n\n\nThe shopper's birth date.\n\n12\n\nNumeric\n\n\n\nThe shopper's social security number.\n\n13\n\nAllowed values:NaturalPersonCompany\n\n\n\nThe type of the entity the payout is processed for.\u00a0\n\n14\n\nAlphabetic\n\n\n\nThe shopper's nationality.A valid value is an ISO 2-character country code (e.g. 'NL').\n\nRecurring\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 PayoutDetails\u00a0and\u00a0Recurring\u00a0sub-lines described above, a payout request needs to include\u00a0either a\u00a0Card,\u00a0BankAccount, or\u00a0IBAN\u00a0payment method.\n\nFor this payout, you need a user role with permission to store payout details.\n\n\n\nThis sub-line holds information about card payments.\nIn an authorization 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 (eg: 03)\n\n6\n\nNumeric\n\n\n\nExpiry year.Format: YYYY (eg: 2016)\n\n7\n\nNumeric\n\n\n\nCVC code.Three-digit CVC\/CVV code (Visa, Mastercard, Discover)Four-digit CVC\/CVV code (American Express)\n\n8\n\nAlphanumeric\n\n\n\nCardholder name.\n\n9\n\nNumeric\n\n\n\nStart month.Format: MM, zero-padded (eg: 03)Maestro UK only.\n\n10\n\nNumeric\n\n\n\nStart year.Format: YYYY (eg: 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,Payout,MerchantReference,\nSL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL\nSL,2,Card,4444333322221111,12,2012,J. de Tester,,,\nSL,3,Recurring,PAYOUT,LATEST\nBT,1 \nFT,1\nBankAccount\nBesides the required\u00a0PayoutDetails\u00a0and\u00a0Recurring\u00a0sub-lines described above, a payout request needs to include\u00a0either a\u00a0Card,\u00a0BankAccount, or\u00a0IBAN\u00a0payment methods.\n\nFor this payout, 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,Payout,MerchantReference,\nSL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL\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\u00a0PayoutDetails\u00a0and\u00a0Recurring\u00a0sub-lines described above, a payout request needs to include\u00a0either a\u00a0Card,\u00a0BankAccount, or\u00a0IBAN\u00a0payment methods.\n\nFor this payout, 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\n\nFH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData \nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,Payout,MerchantReference,\nSL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL\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":"Payout request file","lvl6":"Payout 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\/payout-request-file","lvl6":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/payout-request-file\/payout-request"},"levels":7,"category":"Development Resources","category_color":"green","tags":["Payout","request"]}}
