{"title":"RefundWithData request","category":"default","creationDate":1779706501,"content":"<h2 id=\"mandatory-sub-lines\">Mandatory sub-lines<\/h2>\n<p>The <a href=\"#paymentdetails\">\n  <code>PaymentDetails<\/code>\n<\/a> sub-line along with either a <code>Card<\/code> or <code>IBAN<\/code> sub-line described below are mandatory when submitting a\u00a0bank transfer authorisation request.<\/p>\n<h3 id=\"paymentdetails\">PaymentDetails<\/h3>\n<table>\n    <thead>\n        <tr class=\"header\">\n            <th><p><strong>Field #<\/strong><\/p><\/th>\n            <th><p><strong>Format<\/strong><\/p><\/th>\n            <th><p><strong>Field Required<\/strong><\/p><\/th>\n            <th><p><strong>Value Required<\/strong><\/p><\/th>\n            <th><p><strong>Description<\/strong><\/p><\/th>\n        <\/tr>\n    <\/thead>\n    <tbody>\n        <tr>\n            <td>\n<p>1<\/p>\n<\/td>\n            <td>\n<p>Fixed value: <code>SL<\/code><\/p>\n<\/td>\n            <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>\n            <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>\n            <td>\n<p>Record type identifier<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>2<\/p>\n<\/td>\n            <td>\n<p>Numeric<\/p>\n<\/td>\n            <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>\n            <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>\n            <td>\n<p><code>SL<\/code> sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>3<\/p>\n<\/td>\n            <td>\n<p>Fixed value:\u00a0<code>PaymentDetails<\/code><\/p>\n<\/td>\n            <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>\n            <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>\n            <td>\n<p>Transaction type. <br>Defines the required field types for the specific sub-line.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>4<\/p>\n<\/td>\n            <td>\n<p>Numeric<\/p>\n<\/td>\n            <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>\n            <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>\n            <td>\n<p>Amount.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>5<\/p>\n<\/td>\n            <td>\n<p>Numeric<\/p>\n<\/td>\n            <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>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <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>\n        <\/tr>\n        <tr>\n            <td>\n<p>6<\/p>\n<\/td>\n            <td>\n<p>Alphabetic<\/p>\n<\/td>\n            <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>\n            <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>\n            <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>\n        <\/tr>\n        <tr>\n            <td>\n<p>7<\/p>\n<\/td>\n            <td>\n<p>Alphanumeric<\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>A shopper's reference, which is the unique identifier for a shopper.<div class=\"sc-notice note\"><div>Required element for\u00a0recurring payments\u00a0and to create\u00a0<a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\">recurring contracts<\/a>.<\/div><\/div><\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>8<\/p>\n<\/td>\n            <td>\n<p>Email address<\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>The shopper's email address.<div class=\"sc-notice note\"><div>Required element for\u00a0recurring payments\u00a0and to create\u00a0<a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\">recurring contracts<\/a>.<\/div><\/div><\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>9<\/p>\n<\/td>\n            <td>\n<p>Alphanumeric<\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <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>\n        <\/tr>\n        <tr>\n            <td>\n<p>10<\/p>\n<\/td>\n            <td>\n<p>IP address<\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>The IP address the shopper used to carry out the transaction.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>11<\/p>\n<\/td>\n            <td>\n<p>Numeric<\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>Fraud offset.<br \/>\nThe value to be applied to offset the calculated risk score.<br \/>\nIt can be either a positive or a negative value.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>12<\/p>\n<\/td>\n            <td>\n<p>YYYY-MM-DD<\/p>\n<\/td>\n            <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>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>The shopper's birth date.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>13<\/p>\n<\/td>\n            <td>\n<p>Numeric<\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>The shopper's social security number.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>14<\/p>\n<\/td>\n            <td>\n<p>Allowed values:<ul><li markdown=\"1\"><code>NaturalPerson<\/code><\/li><li markdown=\"1\"><code>Company<\/code><\/li><\/ul><\/p>\n<\/td>\n            <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>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>The type of the entity the payout is processed for.<\/p>\n<\/td>\n        <\/tr>\n        <tr>\n            <td>\n<p>15<\/p>\n<\/td>\n            <td>\n<p>Alphabetic<\/p>\n<\/td>\n            <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>\n            <td>\n<p><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/p>\n<\/td>\n            <td>\n<p>The shopper's nationality.A valid value is an ISO 2-character country code (e.g. 'NL').<\/p>\n<\/td>\n        <\/tr>\n    <\/tbody>\n<\/table>\n<h4>Example PaymentDetails sub-lines<\/h4>\n<p>The following example sub-line is valid:<br \/>\n<code>SL,1,PaymentDetails,1000,2,USD,1991-01-11,NaturalPerson,US<\/code><\/p>\n<ul>\n<li>It includes all the fields that are required (amount, currency exponent, ISO currency code, shopper's birth date, type of entity, shopper's nationality)<\/li>\n<li>It contains a value for each required field (respectively: 1000, 2, USD, 1991-01-11, NaturalPerson, US)<\/li>\n<\/ul>\n<p>The following example sub-line is also valid:<br \/>\n<code>SL,1,PaymentDetails,1000,,USD,,,<\/code><\/p>\n<ul>\n<li>It includes all the fields that are required (amount, currency exponent, ISO currency code, shopper's birth date, type of entity, shopper's nationality)<\/li>\n<li>It contains an empty value for required fields that do not need a value (currency exponent, shopper's birth date, type of entity, shopper's nationality)<\/li>\n<\/ul>\n<p>The following example sub-line is not valid:<br \/>\n<code>SL,1,PaymentDetails,1000,USD<\/code><\/p>\n<ul>\n<li>It doesn't include all the required fields and (empty) values.<\/li>\n<\/ul>\n<h3 id=\"card\">Card<\/h3>\n<p>Besides the required <a href=\"#paymentdetails\">\n  <code>PaymentDetails<\/code>\n<\/a> sub-line described above, a refund with data request needs to include either a <code>Card<\/code> or <code>IBAN<\/code> sub-line.<\/p>\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<!-- list separator -->\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,TestRefundWithData,1,ws@Company.TestCompany,RefundWithData,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,RefundWithData,40975\nSL,1,PaymentDetails,1000,2,EUR,ShopperRef28411,test-payout@adyen.com,TESTING TX01234156XT,,,2017-01-11,123456789,NaturalPerson,NL\nSL,2,Card,4111111111111111,06,2016,CardHolderName,,,\nBT,1\nFT,1<\/code><\/pre>\n<h3 id=\"iban\">IBAN<\/h3>\n<p>Besides the required <a href=\"#paymentdetails\">\n  <code>PaymentDetails<\/code>\n<\/a> sub-line described above, a refund with data request needs to include either a <code>Card<\/code> or <code>IBAN<\/code> sub-line.<\/p>\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<!-- list separator -->\n<pre><code class=\"language-text\">FH,1.0,TEST,Company,TestCompany,TestRefundWithData,1,ws@Company.TestCompany,RefundWithData,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,RefundWithData,40975\nSL,1,PaymentDetails,1000,2,EUR,ShopperRef28411,test-payout@adyen.com,TESTING TX01234156XT,,,2017-01-11,123456789,NaturalPerson,NL\nSL,2,IBAN,Test Testing,NL,NL13TEST0123456789\nBT,1\nFT,1<\/code><\/pre>\n<h2 id=\"optional-sub-lines\">Optional sub-lines<\/h2>\n<p>The <code>Address<\/code> sub-line described below can be optionally included in the payment request.<\/p>\n<h3 id=\"address\">Address<\/h3>\n<div class=\"sc-notice info\"><div>\n<p>You can use the\u00a0<code>Address<\/code> sub-line to include information about the shopper's billing and delivery addresses.<br \/>\nYou need to specify billing and deliver addresses on separate\u00a0<code>Address<\/code> sub-lines:<\/p>\n<ul>\n<li>One\u00a0<code>Address<\/code> sub-line containing the billing address information;<\/li>\n<li>One\u00a0<code>Address<\/code> sub-line containing the delivery address information.<\/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>Address<\/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>Allowed values:<ul><li markdown=\"1\"><code>Billing<\/code><\/li><li markdown=\"1\"><code>Delivery<\/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 address that is being submitted: either a billing or a delivery address.<\/p>\n<\/td><\/tr><tr><td>\n<p>5<\/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>Street address.<\/p>\n<\/td><\/tr><tr><td>\n<p>6<\/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>House number or name.<\/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>City.<\/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>ZIP\/Post code.<\/p>\n<\/td><\/tr><tr><td>\n<p>9<\/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>State\/Province\/Region.<\/p>\n<\/td><\/tr><tr><td>\n<p>10<\/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><\/tbody><\/table>","url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/refundwithdata-request-file\/refundwithdata-request","articleFields":{"feedback_component":true,"id":"24216657","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"23-07-2021 16:53"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/refundwithdata-request-file\/refundwithdata-request","title":"RefundWithData request","content":"Mandatory sub-lines\nThe \n  PaymentDetails\n sub-line along with either a Card or IBAN sub-line described below are mandatory when submitting a\u00a0bank transfer authorisation request.\nPaymentDetails\n\n    \n        \n            Field #\n            Format\n            Field Required\n            Value Required\n            Description\n        \n    \n    \n        \n            \n1\n\n            \nFixed value: SL\n\n            \n\n\n            \n\n\n            \nRecord type identifier\n\n        \n        \n            \n2\n\n            \nNumeric\n\n            \n\n\n            \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\n        \n        \n            \n3\n\n            \nFixed value:\u00a0PaymentDetails\n\n            \n\n\n            \n\n\n            \nTransaction type. Defines the required field types for the specific sub-line.\n\n        \n        \n            \n4\n\n            \nNumeric\n\n            \n\n\n            \n\n\n            \nAmount.\n\n        \n        \n            \n5\n\n            \nNumeric\n\n            \n\n\n            \n\n\n            \nThe currency exponent.\n\n        \n        \n            \n6\n\n            \nAlphabetic\n\n            \n\n\n            \n\n\n            \nThe three-character ISO currency code.\n\n        \n        \n            \n7\n\n            \nAlphanumeric\n\n            \n\n\n            \n\n\n            \nA shopper's reference, which is the unique identifier for a shopper.Required element for\u00a0recurring payments\u00a0and to create\u00a0recurring contracts.\n\n        \n        \n            \n8\n\n            \nEmail address\n\n            \n\n\n            \n\n\n            \nThe shopper's email address.Required element for\u00a0recurring payments\u00a0and to create\u00a0recurring contracts.\n\n        \n        \n            \n9\n\n            \nAlphanumeric\n\n            \n\n\n            \n\n\n            \nShopper statement.\nThe soft descriptor for the transaction.\n\n        \n        \n            \n10\n\n            \nIP address\n\n            \n\n\n            \n\n\n            \nThe IP address the shopper used to carry out the transaction.\n\n        \n        \n            \n11\n\n            \nNumeric\n\n            \n\n\n            \n\n\n            \nFraud offset.\nThe value to be applied to offset the calculated risk score.\nIt can be either a positive or a negative value.\n\n        \n        \n            \n12\n\n            \nYYYY-MM-DD\n\n            \n\n\n            \n\n\n            \nThe shopper's birth date.\n\n        \n        \n            \n13\n\n            \nNumeric\n\n            \n\n\n            \n\n\n            \nThe shopper's social security number.\n\n        \n        \n            \n14\n\n            \nAllowed values:NaturalPersonCompany\n\n            \n\n\n            \n\n\n            \nThe type of the entity the payout is processed for.\n\n        \n        \n            \n15\n\n            \nAlphabetic\n\n            \n\n\n            \n\n\n            \nThe shopper's nationality.A valid value is an ISO 2-character country code (e.g. 'NL').\n\n        \n    \n\nExample PaymentDetails sub-lines\nThe following example sub-line is valid:\nSL,1,PaymentDetails,1000,2,USD,1991-01-11,NaturalPerson,US\n\nIt includes all the fields that are required (amount, currency exponent, ISO currency code, shopper's birth date, type of entity, shopper's nationality)\nIt contains a value for each required field (respectively: 1000, 2, USD, 1991-01-11, NaturalPerson, US)\n\nThe following example sub-line is also valid:\nSL,1,PaymentDetails,1000,,USD,,,\n\nIt includes all the fields that are required (amount, currency exponent, ISO currency code, shopper's birth date, type of entity, shopper's nationality)\nIt contains an empty value for required fields that do not need a value (currency exponent, shopper's birth date, type of entity, shopper's nationality)\n\nThe following example sub-line is not valid:\nSL,1,PaymentDetails,1000,USD\n\nIt doesn't include all the required fields and (empty) values.\n\nCard\nBesides the required \n  PaymentDetails\n sub-line described above, a refund with data request needs to include either a Card or IBAN sub-line.\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\n\nFH,1.0,TEST,Company,TestCompany,TestRefundWithData,1,ws@Company.TestCompany,RefundWithData,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,RefundWithData,40975\nSL,1,PaymentDetails,1000,2,EUR,ShopperRef28411,test-payout@adyen.com,TESTING TX01234156XT,,,2017-01-11,123456789,NaturalPerson,NL\nSL,2,Card,4111111111111111,06,2016,CardHolderName,,,\nBT,1\nFT,1\nIBAN\nBesides the required \n  PaymentDetails\n sub-line described above, a refund with data request needs to include either a Card or IBAN sub-line.\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,TestRefundWithData,1,ws@Company.TestCompany,RefundWithData,FileHeaderEchoData\nBH,1,BlockHeaderEchoData\nL,1,MerchantAccount,TestMerchant,RefundWithData,40975\nSL,1,PaymentDetails,1000,2,EUR,ShopperRef28411,test-payout@adyen.com,TESTING TX01234156XT,,,2017-01-11,123456789,NaturalPerson,NL\nSL,2,IBAN,Test Testing,NL,NL13TEST0123456789\nBT,1\nFT,1\nOptional sub-lines\nThe Address sub-line described below can be optionally included in the payment request.\nAddress\n\nYou can use the\u00a0Address sub-line to include information about the shopper's billing and delivery addresses.\nYou need to specify billing and deliver addresses on separate\u00a0Address sub-lines:\n\nOne\u00a0Address sub-line containing the billing address information;\nOne\u00a0Address sub-line containing the delivery address information.\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:\u00a0Address\n\n\n\nTransaction type. Defines the required field types for the specific sub-line.\n\n4\n\nAllowed values:BillingDelivery\n\n\n\nThe type of address that is being submitted: either a billing or a delivery address.\n\n5\n\nAlphanumeric\n\n\n\nStreet address.\n\n6\n\nAlphanumeric\n\n\n\nHouse number or name.\n\n7\n\nAlphanumeric\n\n\n\nCity.\n\n8\n\nAlphanumeric\n\n\n\nZIP\/Post code.\n\n9\n\nAlphanumeric\n\n\n\nState\/Province\/Region.\n\n10\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","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":"RefundWithData request file","lvl6":"RefundWithData 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\/refundwithdata-request-file","lvl6":"\/development-resources\/batch-processing\/advanced-sftp-batch-files\/batch-request-file\/refundwithdata-request-file\/refundwithdata-request"},"levels":7,"category":"Development Resources","category_color":"green","tags":["RefundWithData","request"]}}